SecurityElement::SearchForTextOfTag Method (String^)

.NET Framework (current version)

Finds a child by its tag name and returns the contained text.

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

Syntax

public:
String^ SearchForTextOfTag(
	String^ tag
)

Parameters

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

Return Value

Type: System::String^

The text contents of the first child element with the specified tag value.

Exceptions

Exception	Condition
ArgumentNullException	tag is null.

Remarks

This method is equivalent to the following:

C++

String^ SearchForTextOfTag(String^ tag)
{
    SecurityElement^ element = this->SearchForChildByTag(tag);
    return element->Text;
}

With XML as follows, SearchForTextOfTag("second") would return "text2".

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

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

C++

String^ storedDestroyTime = localXmlElement->SearchForTextOfTag( L"destroytime" );

Version Information

.NET Framework
Available since 1.1