CodeIdentifiers.AddUnique(String, Object) Methode

Definition

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.Adds a named code entity or type mapping to the CodeIdentifiers instance's scope, ensuring that the name is unique within the scope.

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.A candidate name that is used to index the code entity.

value
Object

Die Informationen zur Codeentität oder der Typzuordnung.The code entity or type mapping information.

Gibt zurück

String

Der Bezeichnerparameterwert oder eine geänderte Zeichenfolge, wenn ein Namenskonflikt vorliegt.The identifier parameter value or a modified string if there is a name collision.

Hinweise

Wenn der bezeichnerparameterwert innerhalb des Bereichs der CodeIdentifiers Instanz nicht eindeutig ist, wird eine neue, eindeutige Zeichenfolge generiert und an seiner Stelle verwendet.If the identifier parameter value is not unique within the CodeIdentifiers instance's scope, a new, unique string is generated and used in its place. Die neue Zeichenfolge wird generiert, indem an den Eingabe Namen angehängt wird.The new string is generated by appending to the input name. Der ursprüngliche Name ist nicht eindeutig, wenn er zuvor an die Add-, AddUnique-oder AddReserved-Methode oder, wenn er durch einen vorherigen-Befehl der AddUnique-Methode generiert wurde, übermittelt wurde.The original name is not unique if it was passed previously to the Add, AddUnique, or AddReserved method, or if it was generated by a previous call to the AddUnique method. In jedem Fall, wenn der neue Bezeichner nicht eindeutig ist, wird er zuerst an die MakeUnique-Methode zum Erstellen eines neuen eindeutigen Bezeichners übermittelt.In each case, if the new identifier is not unique, it is first passed to the MakeUnique method to create a new unique identifier.

Wenn Sie die Namen von Code Entitäten steuern möchten, die an XML-Schema-oder Webdienst Definitionen gebunden sind, verwenden Sie die zugeordneten Attribute, anstatt eine Instanz der CodeIdentifiers-Klasse zu erstellen.If you want to control the names of code entities that are bound to XML Schema or Web service definitions, use the associated attributes rather than creating an instance of the CodeIdentifiers class. Eine komplette Liste finden Sie unter Attribute, die die XML-Serialisierung steuern.For a complete list, see Attributes That Control XML Serialization.

Gilt für: