다음을 통해 공유


DataContractAttribute.Name 속성

정의

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

public:
 property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public string Name { get; set; }
public string? Name { get; set; }
member this.Name : string with get, set
Public Property Name As String

속성 값

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

설명

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

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

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

적용 대상