DataContractAttribute.Name Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia nazwę kontraktu danych dla typu.
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, setPublic Property Name As StringWartość właściwości
Lokalna nazwa kontraktu danych. Wartość domyślna to nazwa klasy, do którego jest stosowany atrybut.
Uwagi
Właściwość Name służy do nadania nazwy kontraktowi danych, który jest nazwą typu w schemacie XML. Aby uzyskać więcej informacji, zobacz Nazwy kontraktów danych.
Domyślnie nazwa kontraktu danych to nazwa typu, do którego DataContractAttribute jest stosowany. Jednak mogą wystąpić powody zmiany tej nazwy domyślnej. Jednym z powodów jest umożliwienie istniejącemu typowi przetwarzania danych, które muszą być zgodne z istniejącym kontraktem danych. Na przykład istnieje typ o nazwie Person , ale kontrakt danych, wbudowany w schemat XML, wymaga nazwy Customer. Kontrakt można spełnić, ustawiając wartość właściwości na Customer.
Drugim powodem jest umożliwienie generowania nazw, które są nieprawidłowe jako nazwy typów. Jeśli na przykład kontrakt danych wymaga nazwy, która nie jest dozwolona jako nazwa typu, ustaw wartość właściwości na tę niedozwoloną nazwę. Na przykład ciąg "$value" jest niedozwolony jako nazwa typu, ale jest dozwolony jako Name wartość właściwości.
