IXmlPropertySet.GetPropertiesByAttribute Method

Returns the set of names and values for elements which have the specified attribute value.

[Visual Basic .NET]
Public Sub GetPropertiesByAttribute ( _
    ByVal Attribute As String, _
    ByVal Value As String, _
    ByVal noValues As Boolean, _
    ByRef Tags As Object, _
    ByRef values As Object _
)

[C#]
public void GetPropertiesByAttribute (
    string Attribute,
    string Value,
    bool noValues,
    ref object Tags,
    ref object values
);

[C++]
HRESULT GetPropertiesByAttribute(
  BSTR Attribute,
  BSTR Value,
  VARIANT_BOOL noValues,
  VARIANT* Tags,
  VARIANT* values
);

[C++]

Parameters
Attribute [in]
  Attribute is a parameter of type BSTR
Value [in]
  Value is a parameter of type BSTR
noValues [in]
  noValues is a parameter of type VARIANT_BOOL
Tags [out]
  Tags is a parameter of type VARIANT
values [out]
  values is a parameter of type VARIANT

Product Availability

Description

The GetPropertiesByAttribute method returns the set of metadata elements where the specific XML attribute has the specified value.

Remarks

The Attribute parameter specifies the name of the attribute within the Xml metadata element. The Value parameter is the string the attribute is evaluated to or equals. For instance in the example <idinfo/citation/citeinfo/title Sync="TRUE"> the Sync Attribute has a Value of "TRUE".

When used to retrieve a property of type esriXPTBinaryEnclosure or esriXPTImage, the file is extracted from the metadata to a temporary directory and the path of the file is returned as the value. With properties of type esriXPTPicture, the value is an IPicture.

The noValues parameter is currently reserved and has no effect.

See Also

IXmlPropertySet Interface