CodeIdentifiers.AddUnique(String, Object) Methode

Definition

Namespace:

System.Xml.Serialization

Assembly:

System.Xml.XmlSerializer.dll

Quelle:

CodeIdentifiers.cs

Fügt dem Gültigkeitsbereich der CodeIdentifiers-Instanz eine benannte Codeentität oder Typzuordnung hinzu und stellt sicher, dass der Name im Gültigkeitsbereich eindeutig ist.

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht.

public:
 System::String ^ AddUnique(System::String ^ identifier, System::Object ^ value);

public string AddUnique (string identifier, object? value);

member this.AddUnique : string * obj -> string

Public Function AddUnique (identifier As String, value As Object) As String

Parameter

identifier

String

Ein möglicher Name, mit dessen Hilfe die Codeentität indiziert wird.

value

Object

Die Informationen zur Codeentität oder der Typzuordnung.

Gibt zurück

String

Der Bezeichnerparameterwert oder eine geänderte Zeichenfolge, wenn ein Namenskonflikt vorliegt.

Hinweise

Wenn der Wert des Bezeichnerparameters im Bereich der CodeIdentifiers Instanz nicht eindeutig ist, wird eine neue, eindeutige Zeichenfolge generiert und an ihrer Stelle verwendet. Die neue Zeichenfolge wird durch Anfügen an den Eingabenamen generiert. Der ursprüngliche Name ist nicht eindeutig, wenn er zuvor an die Add- AddUniqueAddReserved oder -Methode übergeben wurde oder wenn er durch einen vorherigen Aufruf der AddUnique -Methode generiert wurde. Wenn der neue Bezeichner in jedem Fall nicht eindeutig ist, wird er zuerst an die MakeUnique -Methode übergeben, um einen neuen eindeutigen Bezeichner zu erstellen.

Wenn Sie die Namen von Codeentitäten steuern möchten, die an XML-Schema- oder Webdienstdefinitionen gebunden sind, verwenden Sie die zugeordneten Attribute, anstatt eine Instanz der CodeIdentifiers -Klasse zu erstellen. Eine vollständige Liste finden Sie unter Attribute, die die XML-Serialisierung steuern.