Help topic for PropertyItem class is not complete (821623)

Encapsulates a metadata property to be included in an image file. Not inheritable.

A PropertyItem is not intended to be used as a stand-alone object. A PropertyItem object is intended to be used by classes that are derived from System.Drawing.Image. A PropertyItem object is used to retrieve and to change the metadata of existing image files, not to create the metadata. Therefore, the PropertyItem class does not have a defined Public constructor, and you cannot create an instance of a PropertyItem object.

To work around the missing Public constructor, use an existing PropertyItem object instead of creating a new instance of the PropertyItem class. To do this, use the following sample code:

Visual Basic .NET sample code

' Create an Image to gain access to an existing PropertyItem object from.
Dim MyImage As System.Drawing.Image = Image.FromFile("C:\Sample.jpg") ' Refer to some existing .JPEG image.

' Define a PropertyItem variable.
Dim pItem As System.Drawing.Imaging.PropertyItem

' Instead of creating a new instance of PropertyItem, use an existing PropertyItem object.
For Each pItem In MyImage.PropertyItems
   ' Obtain a reference to the first PropertyItem object of MyImage, and then exit the loop.
   Exit For
Next

' You may modify and use the pItem object now.

Visual C# .NET sample code

// Create an Image to gain access to an existing PropertyItem object from.
System.Drawing.Image MyImage = Image.FromFile("C:\\Sample.jpg");  // Refer to some existing .JPEG image.

// Instead of creating a new instance of PropertyItem, use an existing PropertyItem object.
foreach (System.Drawing.Imaging.PropertyItem pItem in MyImage.PropertyItems)
{
   // Obtain a reference to the first PropertyItem object of MyImage, and then exit the loop.
   break;
}

// You may modify and use the pItem object now.