SecurityElement::SearchForChildByTag Method (String^)

.NET Framework (current version)

Finds a child by its tag name.

Namespace: System.Security
Assembly: mscorlib (in mscorlib.dll)

Syntax

public:
SecurityElement^ SearchForChildByTag(
	String^ tag
)

Parameters

tag: Type: System::String^
The tag for which to search in child elements.

Return Value

Type: System.Security::SecurityElement^

The first child XML element with the specified tag value, or null if no child element with tag exists.

Exceptions

Exception	Condition
ArgumentNullException	The tag parameter is null.

Remarks

With XML as follows, SearchForChildByTag("second") would return the child element <second>.

<thetag A="123" B="456" C="789"> <first>text1</first>
       <second>text2</second></thetag>

Examples

The following code shows the use of the SearchForChildByTag method to find a child by its tag name. This code example is part of a larger example provided for the SecurityElement class.

C++

if ( localXmlElement->SearchForChildByTag( L"destroytime" ) != nullptr )

Version Information

.NET Framework
Available since 1.1