CodeIdentifiers.AddUnique(String, Object) Method

Reference

Definition

Namespace:: System.Xml.Serialization

Assembly:: System.Xml.XmlSerializer.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: CodeIdentifiers.cs

Source:: CodeIdentifiers.cs

Source:: CodeIdentifiers.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds a named code entity or type mapping to the CodeIdentifiers instance's scope, ensuring that the name is unique within the scope.

This API supports the product infrastructure and is not intended to be used directly from your code.

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

public string AddUnique (string identifier, 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

Parameters

identifier: String

A candidate name that is used to index the code entity.

value: Object

The code entity or type mapping information.

Returns

String

The identifier parameter value or a modified string if there is a name collision.

Remarks

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. The new string is generated by appending to the input name. 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 each case, if the new identifier is not unique, it is first passed to the MakeUnique method to create a new unique identifier.

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. For a complete list, see Attributes That Control XML Serialization.

Applies to