Liste aller Codebeispiele

Diese Hilfsroutine liefert die Werte eines Attributs in einem durch Semikola getrennten String

Ein Beispiel zum Einsatz der Klasse System.DirectoryServices.DirectoryEntry aus der .NET-Klassenbibliothek.

Autor: Dr. Holger Schwichtenberg

Beschreibung

Während das Classic-ADSI nur diejenigen Attribute, die mehrwertig sind, als Array zurückliefert, gibt .NET-ADSI immer eine PropertyValueCollection zurück. Dies hat zur Folge, dass auch bei einwertigen Attributen immer explizit das erste Element der Liste angesprochen werden muss.

Während ein Attributzugriff im Classic-ADSI in der Regel so aussah

xy = obj.Attributname

ist also in .NET-ADSI mehr Aufwand nötig:

xy = obj.Properties("Attributname ")(0)

Wenn ein Attribut keinen Wert hat, dann führt der Zugriff auf das Attribut in .NET genauso zu einem Fehler wie in COM-ADSI. Während man dies in COM nur mit der Laufzeitfehlerbehandlung (on error…) abfangen konnte, bietet die FCL nun eine elegantere Möglichkeit über die Abfrage des Attributs Count in der PropertyValueCollection.

obj.Properties("Attributname").Count

Wenn Count den Wert 0 hat, dann besitzt das Attribut keinen Wert.
Bei mehrwertigen Attributen liefert Count die Anzahl der vorhandenen Werte. Auf die einzelnen Werte kann dann über den Index in der PropertyValueCollection zugegriffen werden:

obj.Properties("Attributname")(INDEX)

Die verschiedenen Prüfungsvorgänge beim Auslesen eines Verzeichnisattributs kann man gut in eine Hilfsroutine packen. Die Funktion getAtt() erwartet als Parameter einen Zeiger auf ein DirectoryEntry-Objekt und den Namen eines Attributs. Sie liefert eine Zeichenkette (System.String) mit dem Attributwert zurück. Bei mehrwertigen Attributen werden die Einzelwerte durch ein Semikolon voneinander getrennt.

Programmcodebeispiele Visual Basic .NET (VB.NET)

' ### Liefert die Werte eines Attributs In einem durch Semikola getrennten String
Function getAtt(ByVal se As Object, ByVal attributname As String) As String
Dim werteliste As Object
'ResultPropertyValueCollection oder
'PropertyValueCollection
Dim wert As Object ' einzelner Wert
Dim ergebnis As String ' Rückgabestring

' --- Prüfung, ob Attribut vorhanden
If se.Properties.Contains(attributname) Then
' --- Zugriff auf Wertemenge
werteliste = se.Properties(attributname)
' --- Schleife über alle Werte
For Each wert In werteliste
' --- Ergebnis zusammensetzen
If Len(ergebnis) = 0 Then
ergebnis = wert
Else
ergebnis = ergebnis & ";" & wert
End If

Next
End If
Return (ergebnis)
End Function

Programmcodebeispiele CSharp (C#)

using System;
using System.DirectoryServices;

namespace FCLBuch._SystemDirectoryServices {

public class ADSI_HelperMethods {
public static string GetAtt(object se, string attributname) {

// Liefert die Wert eines Attributs in einem durch Semikola getrennten String
PropertyValueCollection werteliste; // PropertyValueCollection
string ergebnis = String.Empty; // Rückgabestring

// se kann DirectoryEntry oder SearchResult sein
DirectoryEntry de = (se is SearchResult) ? ((SearchResult)se).GetDirectoryEntry() : ((DirectoryEntry)se);

// Prüfung, ob Attribut vorhanden
if (de.Properties.Contains(attributname)) {
// Zugriff auf Wertemenge
werteliste = de.Properties[attributname];

// Schleife über alle Werte
foreach ( object wert in werteliste ) {
// Ergebnis zusammensetzen
if (ergebnis.Length == 0)
ergebnis = wert.ToString();
else
ergebnis = ergebnis + ";" + wert.ToString();
}
}
return ergebnis;
}
}
}

 

Querverweise

 Definition '.NET Framework Class Library'  Verfügbarkeit der Klasse 'System.DirectoryServices.DirectoryEntry'  Übersicht über den FCL-Namensraum 'System.DirectoryServices'  .NET & Visual Studio Community Portal

Buchtipp

Beratung & Support:

Schulungen zu diesem Thema:

 Visual Basic .NET - Aufbauwissen
 Grundlagen der objektorientierten Programmierung anhand von C# oder Visual Basic .NET
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) von .NET-Anwendungen (C#/Visual Basic .NET)
 Visual Basic 6.0 (VB6.0)
 Objektorientierte Entwurfsmuster (Design Patterns) mit .NET (C#, Visual Basic .NET, C++/CLI)
 Visual Basic .NET - Basiswissen
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), XAML und .NET/C#/Visual Basic
 Visual Basic Script (VBScript/VBS) - Sprachsyntax und Praxiseinsatz
 Word-Programmierung mit Visual Basic for Applications (VBA)
 Visual Studio Tools for Microsoft Office (VSTO) - Microsoft Office-Programmierung mit .NET und C# oder Visual Basic in Visual Studio
 Parallelprogrammierung mit .NET (Multi-Threading/Multi-Tasking) - mit C#/Visual Basic und/oder C++
 C# für Umsteiger von Visual Basic .NET
 Objektorientierte Programmierung (OOP) mit C#, Java, C++, Visual Basic.NET o.ä.
 Excel-Programmierung mit Visual Basic for Applications (VBA)
 Visual Basic .NET für Umsteiger von VBA/VB 4/5/6
 Visual Basic 2005 (Visual Basic 8.0)
 C# für Umsteiger von klassischem Visual Basic/COM
 Outlook-Programmierung mit Visual Basic for Applications (VBA)
 Das Component Object Model - für Script- und Visual Basic-Entwickler
 .NET Micro Framework - Embedded-Entwicklung mit .NET/C# oder C++
 .NET-Akademie: .NET-/.NET Core-/C#-Basisseminar: Softwarearchitektur, Techniken, Pattern, Best Practices (2-Tages-Agenda des öffentlichen Seminars)
 Neuerungen in C# 5.0
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Neuerungen in C# 7.0/7.1/7.2/7.3
 .NET und C# für Umsteiger von Java
 .NET Akademie: Xamarin: .NET-/C#-Cross-Plattform-Entwicklung für iOS (iPhone, iPad) und Android sowie Windows Phone (3-Tages-Agenda des öffentlichen Seminars)
 Task Parallel Library (TPL) - Parallelprogrammierung/Multi-Threading in .NET/C#
 Neuerung in der CLR 2.0 und C# 2005
 Neuerungen in C# 4.0 (Visual C# 2010)
 Xamarin: .NET-/C#-Cross-Plattform-Entwicklung für iOS (iPhone, iPad) und Android sowie Windows/Windows Phone
 Anfrage für eine individuelle Schulung zum Thema Visual Basic;C#  Gesamter Schulungsthemenkatalog

Bücher zu diesem Thema:

 Windows Scripting (5. Auflage)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 (PDF)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF-E-Book)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (gedruckte Ausgabe)
 Windows Scripting Lernen 5. Auflage
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (DRUCK)
 Microsoft ASP.NET 2.0 mit C# 2005 - Das Entwicklerbuch
 Essential PowerShell
 ASP.NET Core Blazor 5.0: Blazor WebAssembly und Blazor Server - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (E-Book - PDF, MOBI, EPUB)
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, gedruckte Ausgabe)
 ASP.NET Core Blazor 5.0: Blazor WebAssembly und Blazor Server - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (PDF-E-Book)
 Microsoft ASP.NET 4.5 mit C# 2012 - Entwicklerbuch
 Datenbankprogrammierung mit .NET 4.0. Mit Visual Studio 2010 und SQL Server 2008 R2
 Moderne Datenzugriffslösungen mit Entity Framework 6 (gedruckte Ausgabe)
 Effizienter Datenzugriff mit Entity Framework Core: Datenbankprogrammierung mit C# für .NET Framework, .NET Core und Xamarin
 Microsoft ASP.NET 3.5 mit Visual Basic 2008 - Das Entwicklerbuch
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, PDF-E-Book)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1 und 2.0-Preview2 (Buchversion 1.4)
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, gedruckte Ausgabe)
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (Kindle-E-Book)
 ASP.NET 4.0
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.2 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (PDF)
 Webanwendungen mit ASP.NET 3.5 und AJAX Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (E-Book - PDF)
 Windows Scripting Lernen, 6. Auflage
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (PDF-E-Book)
 C# 7.2 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF-E-Book)
 Windows Scripting Lernen, 2. Auflage
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Kindle-E-Book)
 Microsoft ASP.NET 3.5 mit Visual C# 2008 - Das Entwicklerbuch
 C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin (Kindle-E-Book)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (PDF-E-Book)
 Microsoft .NET 4.5 Update - Crashkurs (E-Book - PDF)
 Einblicke in C# 6.0 (shortcuts 181) Kindle Edition
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (Kindle-E-Book)
 Microsoft Visual C# 2010
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 7.x, PDF-E-Book)
 Office 2010 Programmierung mit VSTO und .NET 4.0: Word, Excel und Outlook erweitern und anpassen
 Microsoft ASP.NET 2.0 mit Visual Basic 2005 - Das Entwicklerbuch
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (gedruckte Ausgabe)
 ASP.NET Core Blazor 5.0: Blazor WebAssembly und Blazor Server - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (Kindle-E-Book)
 Windows PowerShell - Konzepte, Praxiseinsatz, Erweiterungen
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, PDF-E-Book)
 Moderne Datenzugriffslösungen mit Entity Framework 6 (Kindle)
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (Kindle)
 Visual Basic 2010: Grundlagen, ADO.NET, Windows Presentation Foundation
 Moderne Datenzugriffslösungen mit Entity Framework Core 5.0 (Buchversion 9.x, Kindle-E-Book)
 Microsoft ASP.NET 4.0 mit C# 2010
 Microsoft .NET 4.5 Update - Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.1 (Buchversion 8.x, Kindle-E-Book)
 .NET 3.5
 ASP.NET Core Blazor 3.1/3.2: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (gedruckte Ausgabe)
 C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin (PDF-E-Book)
 ASP.NET 4.0 mit Visual C# 2010
 Moderne Webanwendungen für .NET-Entwickler: Server-Anwendungen, Web APIs, SPAs & HTML-Cross-Platform-Anwendungen mit ASP.NET, ASP.NET Core, JavaScript/TypeScript und Angular
 Windows 8 Apps entwickeln mit C# und XAML - Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1.1 und 2.0-Preview2: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.1: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 C# 7.3 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (Kindle-E-Book)
 Microsoft SQL Server 2008 R2 - Das Entwicklerbuch
 .NET 3.5 Crashkurs
 Modern Data Access with Entity Framework Core: Database Programming Using .NET, .NET Core, UWP, and Xamarin with C#
 Microsoft .NET 2.0 Crashkurs - Final Edition
 Moderne Datenzugriffslösungen mit Entity Framework Core 1.x und 2.0: Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Visual Basic 2010
 ASP.NET Core Blazor 3.0/3.1: Blazor Server und Blazor Webassembly - Moderne Single-Page-Web-Applications mit .NET, C# und Visual Studio (PDF)
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0/2.1 (Buchversion 5.x, PDF-E-Book)
 Docker und die Containerwelt - Einstieg und Expertentipps rund um Docker-Container (shortcut)
 C# 8.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET Framework, .NET Core und Xamarin (PDF-E-Book)
 Datenbankprogrammierung mit .NET 4.5. Mit Visual Studio 2012 und SQL Server 2012
 Moderne Datenzugriffslösungen mit Entity Framework Core 3.0 (Buchversion 6.x, Gedruckte Ausgabe)
 C# 9.0 Crashkurs: Die Syntax der Programmiersprache C# für die Softwareentwicklung in .NET 5.0, .NET Core und Xamarin (gedruckte Ausgabe)
 .NET 4.0 Crashkurs
 Moderne Datenzugriffslösungen mit Entity Framework Core 2.0 (Buchversion 4.x): Datenbankprogrammierung mit .NET/.NET Core und C# (gedruckte Ausgabe)
 Alle unsere aktuellen Fachbücher