ValueSerializer.GetSerializerFor Methode

public:
 static System::Windows::Markup::ValueSerializer ^ GetSerializerFor(System::ComponentModel::PropertyDescriptor ^ descriptor);

public static System.Windows.Markup.ValueSerializer GetSerializerFor (System.ComponentModel.PropertyDescriptor descriptor);

static member GetSerializerFor : System.ComponentModel.PropertyDescriptor -> System.Windows.Markup.ValueSerializer

Public Shared Function GetSerializerFor (descriptor As PropertyDescriptor) As ValueSerializer

Parameter

Gibt zurück

Das Serialisierungsprogramm, das der angegebenen Eigenschaft zugeordnet ist. Gibt möglicherweise null zurück.

Ausnahmen

Hinweise

Ein ValueSerializer für eine Eigenschaft oder für einen Typ, der als Wert für eine Eigenschaft verwendet wird, wird durch Anwenden des Attributs auf die ValueSerializerAttribute Eigenschafts- oder Typdeklaration angegeben. Die GetSerializerFor -Methode ist eine Hilfsprogrammmethode, die die CLR-Typsysteminformationen liest und eine neue ValueSerializer Klasse basierend auf dem Attribut zurückgibt, wenn sie für die -Eigenschaft gefunden wird, oder dann, wenn sie für den Typ der Eigenschaft gefunden wird. null kann zurückgegeben werden, wenn kein solches Serialisierungsprogramm vorhanden ist. null kann auch zurückgegeben werden, wenn einem Typ oder einer Eigenschaft bewusst ein NULL-Wert ValueSerializerAttributezugewiesen wird.

Ein weiterer Modus, der unterstützt, GetSerializerFor ist das Zurückgeben der internen TypeConverterValueSerializer Klasse. Hierbei handelt es sich um eine ValueSerializer Implementierung, die eine TypeConverter umschließt und die Convert Methoden in Convert*String Methoden übersetzt (für instance TypeConverter.ConvertTo mit der Eingabe des String Typs aufgerufen wird und in ConvertToStringübersetzt. Dies geschieht nur in Fällen, in denen alle folgenden Punkte zutrifft:

• Ein TypeConverterAttribute befindet sich in der relevanten Eigenschaft oder dem Typ der relevanten Eigenschaft.

• Die angegebene TypeConverter kann erfolgreich erstellt werden.

• Die TypeConverter gibt für TypeConverter.ConvertTozurücktrue, die als Verweis auf den String Typ bezeichnet wird.

• Die TypeConverter gibt für TypeConverter.CanConvertTozurücktrue, die als Verweis auf den String Typ bezeichnet wird.

• Die TypeConverter gibt für TypeConverter.CanConvertFromzurücktrue, die als Verweis auf den String Typ bezeichnet wird.

public:
 static System::Windows::Markup::ValueSerializer ^ GetSerializerFor(Type ^ type);

public static System.Windows.Markup.ValueSerializer GetSerializerFor (Type type);

static member GetSerializerFor : Type -> System.Windows.Markup.ValueSerializer

Public Shared Function GetSerializerFor (type As Type) As ValueSerializer

Parameter

Gibt zurück

Das Serialisierungsprogramm, das dem angegebenen Typ zugeordnet ist. Gibt möglicherweise null zurück.

Ausnahmen

Hinweise

Ein ValueSerializer für einen Typ wird durch Anwenden des ValueSerializerAttribute Attributs auf die Typdeklaration angegeben. Die GetSerializerFor -Methode ist eine Hilfsprogrammmethode, die die CLR-Typsysteminformationen liest und eine neue ValueSerializer Klasse basierend auf dem -Attribut zurückgibt, wenn auf dem angegebenen typegefunden wird. null kann zurückgegeben werden, wenn kein solches Serialisierungsprogramm vorhanden ist. null kann auch zurückgegeben werden, wenn einem Typ absichtlich ein NULL-Wert ValueSerializerAttributezugewiesen wird.

Ein weiterer Modus, der unterstützt, GetSerializerFor ist das Zurückgeben der internen TypeConverterValueSerializer Klasse. Hierbei handelt es sich um eine ValueSerializer Implementierung, die eine TypeConverter umschließt und die Convert Methoden in Convert*String Methoden übersetzt (für instance TypeConverter.ConvertTo mit der Eingabe des String Typs aufgerufen wird und in ConvertToStringübersetzt. Dies geschieht nur in Fällen, in denen alle folgenden Punkte zutrifft:

• Ein TypeConverterAttribute befindet sich in type.

• Die angegebene TypeConverter kann erfolgreich erstellt werden.

• Die TypeConverter gibt für TypeConverter.ConvertTozurücktrue, die als Verweis auf den String Typ bezeichnet wird.

• Die TypeConverter gibt für TypeConverter.CanConvertTozurücktrue, die als Verweis auf den String Typ bezeichnet wird.

• Die TypeConverter gibt für TypeConverter.CanConvertFromzurücktrue, die als Verweis auf den String Typ bezeichnet wird.

public:
 static System::Windows::Markup::ValueSerializer ^ GetSerializerFor(System::ComponentModel::PropertyDescriptor ^ descriptor, System::Windows::Markup::IValueSerializerContext ^ context);

public static System.Windows.Markup.ValueSerializer GetSerializerFor (System.ComponentModel.PropertyDescriptor descriptor, System.Windows.Markup.IValueSerializerContext context);

static member GetSerializerFor : System.ComponentModel.PropertyDescriptor * System.Windows.Markup.IValueSerializerContext -> System.Windows.Markup.ValueSerializer

Public Shared Function GetSerializerFor (descriptor As PropertyDescriptor, context As IValueSerializerContext) As ValueSerializer

Parameter

Gibt zurück

Das Serialisierungsprogramm, das der angegebenen Eigenschaft zugeordnet ist.

Ausnahmen

Hinweise

Anstatt sich nur auf Attribute zu verlassen, die im CLR-Typsystem gemeldet werden, verwendet diese Überladung den context -as-a-Dienst und ruft die Implementierung des Diensts auf IValueSerializerContext.GetValueSerializerFor. Die IValueSerializerContext.GetValueSerializerFor Implementierung basiert in der Regel auch auf dem descriptor, kann jedoch spezielles Verhalten für bestimmte Kontexte implementieren.

Diese Methode sollte aufgerufen werden, wenn der Aufrufer über einen Dienst verfügbar IValueSerializerContext ist. Dadurch wird sichergestellt, dass das richtige ValueSerializer für den spezifischen Kontext zurückgegeben wird.

Wenn der Kontext von seinem IValueSerializerContext.GetValueSerializerFor für den angegebenen descriptorzurückgibt null oder der von Ihnen angegebene Kontext istnull, ist das Verhalten mit dem Aufrufen der GetSerializerFor(PropertyDescriptor) Überladung identisch.

public:
 static System::Windows::Markup::ValueSerializer ^ GetSerializerFor(Type ^ type, System::Windows::Markup::IValueSerializerContext ^ context);

public static System.Windows.Markup.ValueSerializer GetSerializerFor (Type type, System.Windows.Markup.IValueSerializerContext context);

static member GetSerializerFor : Type * System.Windows.Markup.IValueSerializerContext -> System.Windows.Markup.ValueSerializer

Public Shared Function GetSerializerFor (type As Type, context As IValueSerializerContext) As ValueSerializer

Parameter

Gibt zurück

Das Serialisierungsprogramm, das dem angegebenen Typ zugeordnet ist.

Ausnahmen

Hinweise

Anstatt sich nur auf Attribute zu verlassen, die im CLR-Typsystem gemeldet werden, verwendet diese Überladung den context -as-a-Dienst und ruft die Implementierung des Diensts auf IValueSerializerContext.GetValueSerializerFor. Die IValueSerializerContext.GetValueSerializerFor Implementierung basiert in der Regel auch auf dem type, kann jedoch spezielles Verhalten für bestimmte Kontexte implementieren.

Diese Methode sollte aufgerufen werden, wenn der Aufrufer über einen Dienst verfügbar IValueSerializerContext ist. Dadurch wird sichergestellt, dass das richtige ValueSerializer für den spezifischen Kontext zurückgegeben wird.

Wenn der Kontext von seinem IValueSerializerContext.GetValueSerializerFor für den angegebenen typezurückgibt null oder der von Ihnen angegebene Kontext istnull, ist das Verhalten mit dem Aufrufen der GetSerializerFor(Type) Überladung identisch.