DataContractAttribute.Name 속성

정의

네임스페이스:

System.Runtime.Serialization

어셈블리:

netstandard.dll, System.Runtime.Serialization.Primitives.dll

Source:

DataContractAttribute.cs

형식에 대한 데이터 계약의 이름을 가져오거나 설정합니다.

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };

public string? Name { get; set; }

member this.Name : string with get, set

Public Property Name As String

속성 값

String

데이터 계약의 로컬 이름입니다. 기본값은 특성이 적용되는 클래스의 이름입니다.

설명

이 Name 속성은 XML 스키마 형식의 이름인 데이터 계약에 이름을 지정하는 데 사용됩니다. 자세한 내용은 데이터 계약 이름을 참조하세요.

기본적으로 데이터 계약의 이름은 적용되는 형식 DataContractAttribute 의 이름입니다. 그러나 이 기본 이름을 변경하는 데는 이유가 있을 수 있습니다. 한 가지 이유는 기존 형식이 기존 데이터 계약을 준수해야 하는 데이터를 처리하도록 허용하기 위해서입니다. 예를 들어 이름이 지정된 Person 형식이 있지만 XML 스키마에 구현된 데이터 계약에는 이름이 있어야 합니다 Customer. 속성 값을 .로 설정하여 계약을 충족할 Customer수 있습니다.

두 번째 이유는 형식 이름으로 유효하지 않은 이름의 생성을 허용하기 위해서입니다. 예를 들어 데이터 계약에서 형식 이름으로 사용할 수 없는 이름을 요구하는 경우 속성 값을 허용되지 않는 이름으로 설정합니다. 예를 들어 문자열 "$value"는 형식 이름으로 허용되지만 속성 값으로 Name 허용됩니다.