DirectoryEntry::SchemaEntry Property

.NET Framework (current version)

Gets the schema object for this entry.

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in System.DirectoryServices.dll)

Syntax

public:
[BrowsableAttribute(false)]
[DSDescriptionAttribute("DSSchemaEntry")]
property DirectoryEntry^ SchemaEntry {
	DirectoryEntry^ get();
}

Property Value

Type: System.DirectoryServices::DirectoryEntry^

A DirectoryEntry object that represents the schema class for this entry.

Remarks

An entry's schema determines a list of its mandatory and optional property names.

You can use this property to find out what properties and methods are available on the associated object.

The following example demonstrates the SchemaClassName and SchemaEntry properties of the DirectoryEntry class. This example gets the user-specified DirectoryEntry object and gets all of its children if the SchemaEntry object is a container object. The SchemaEntry is a container object if the Name of that object is "container".

C++

String^ myADSPath = "LDAP://onecity/CN=Users,DC=onecity,DC=corp,DC=fabrikam,DC=com";

// Creates an Instance of DirectoryEntry.
DirectoryEntry^ myDirectoryEntry = gcnew DirectoryEntry(myADSPath, UserName, SecurelyStoredPassword);

// Display the 'SchemaClassName'.
Console::WriteLine("Schema class name:{0}", myDirectoryEntry->SchemaClassName);

// Gets the SchemaEntry of the ADS Object*.
DirectoryEntry^ mySchemaEntry = myDirectoryEntry->SchemaEntry;

if (!String::Compare(mySchemaEntry->Name, S"container")) 
{
    Collections::IEnumerator^ myEnum = myDirectoryEntry->Children->GetEnumerator();
    while (myEnum->MoveNext()) 
    {
        DirectoryEntry^ myChildDirectoryEntry = safe_cast<DirectoryEntry^>(myEnum->Current);
        Console::WriteLine(myChildDirectoryEntry->Path);
    }
}

Security

DirectoryServicesPermission

To get the schema object.

Version Information

.NET Framework
Available since 1.1