CodeDomSerializerBase.SerializeToExpression Methode

  • Referenz

Definition

Namespace:
System.ComponentModel.Design.Serialization
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll

Serialisiert das angegebene Objekt in einen Ausdruck.

protected:
 System::CodeDom::CodeExpression ^ SerializeToExpression(System::ComponentModel::Design::Serialization::IDesignerSerializationManager ^ manager, System::Object ^ value);
protected System.CodeDom.CodeExpression SerializeToExpression (System.ComponentModel.Design.Serialization.IDesignerSerializationManager manager, object value);
member this.SerializeToExpression : System.ComponentModel.Design.Serialization.IDesignerSerializationManager * obj -> System.CodeDom.CodeExpression
Protected Function SerializeToExpression (manager As IDesignerSerializationManager, value As Object) As CodeExpression

Parameter

manager
IDesignerSerializationManager

Die für die Serialisierung zu verwendende IDesignerSerializationManager.

value
Object

Das zu serialisierende Objekt. Kann null sein.

Gibt zurück

CodeExpression

Ein CodeExpression-Objekt, wenn value serialisiert werden kann; andernfalls null.

Ausnahmen

ArgumentNullException

manager ist null.

Hinweise

Der value Parameter kann nullsein, in diesem Fall wird ein Grundtypausdruck zurückgegeben.

Die SerializeToExpression Methode verwendet die folgenden Regeln für die Serialisierung von Typen:

  1. Zunächst wird die GetExpression Methode aufgerufen, um zu sehen, ob ein Ausdruck bereits für das Objekt erstellt wurde. Wenn ja, gibt es den vorhandenen Ausdruck zurück.

  2. Anschließend sucht er den Serializer des Objekts, und fordert es auf, sie zu serialisieren.

  3. Wenn der Rückgabewert des Serializers des Objekts ein CodeExpressionist, wird der Ausdruck zurückgegeben.

  4. Es macht einen letzten Aufruf, um zu GetExpression sehen, ob der Serializer einen Ausdruck hinzugefügt hat.

  5. Schließlich gibt es zurück null.

Wenn kein Ausdruck erstellt werden konnte und kein geeigneter Serializer gefunden werden konnte, wird ein Fehler über den Serialisierungs-Manager gemeldet. Es wird kein Fehler gemeldet, wenn ein Serializer gefunden wurde, aber es konnte keinen Ausdruck erstellen. In diesem Fall wird davon ausgegangen, dass der Serializer entweder bereits den Fehler gemeldet hat oder es nicht versucht hat, das Objekt zu serialisieren.

Wenn der Serializer eine Anweisung oder eine Auflistung von Anweisungen zurückgegeben hat, werden diese Anweisungen nicht verworfen. Die SerializeToExpression Methode sucht zunächst nach einem StatementContext Kontextstapel und fügt Anweisungen zur Eigenschaft des Anweisungskontextobjekts StatementCollection hinzu. Wenn kein Anweisungskontext vorhanden ist, sieht die SerializeToExpression Methode im Kontext nach einem CodeStatementCollection und fügen die Anweisungen dort hinzu. Wenn kein Ort gefunden werden kann, um die Anweisungen hinzuzufügen, wird ein Fehler generiert.

Hinweis

Sie sollten die SerializeToExpression Methode Serialize beim Serialisieren Ihres eigenen Objekts nicht aufrufen. Stattdessen sollten Sie aufrufen GetExpression. Wenn sie zurückgegeben nullwird, erstellen Sie Ihren eigenen Ausdruck und rufen Sie an SetExpression. Fahren Sie dann mit der restlichen Serialisierung fort.

Gilt für:

Siehe auch