SoapFieldAttribute Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Passt die SOAP-Generierung und -Verarbeitung für ein Feld an. Diese Klasse kann nicht vererbt werden.
public ref class SoapFieldAttribute sealed : System::Runtime::Remoting::Metadata::SoapAttribute
[System.AttributeUsage(System.AttributeTargets.Field)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute
[System.AttributeUsage(System.AttributeTargets.Field)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class SoapFieldAttribute : System.Runtime.Remoting.Metadata.SoapAttribute
[<System.AttributeUsage(System.AttributeTargets.Field)>]
type SoapFieldAttribute = class
inherit SoapAttribute
[<System.AttributeUsage(System.AttributeTargets.Field)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type SoapFieldAttribute = class
inherit SoapAttribute
Public NotInheritable Class SoapFieldAttribute
Inherits SoapAttribute
- Vererbung
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Anpassung von SOAP veranschaulicht, die für ein Feld einer Klasse mit der SoapFieldAttribute. Die SOAP kann vom im SerializableAttribute Klassenbeispiel gezeigten Code erstellt werden.
[Serializable]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public ref class TestSimpleObject
{
public:
int member1;
[SoapFieldAttribute(XmlElementName="MyXmlElement")] String^ member2;
String^ member3;
double member4;
// A field that is not serialized.
[NonSerialized] String^ member5;
TestSimpleObject()
{
member1 = 11;
member2 = "hello";
member3 = "hello";
member4 = 3.14159265;
member5 = "hello world!";
}
};
[Serializable()]
[SoapTypeAttribute(XmlNamespace="MyXmlNamespace")]
public class TestSimpleObject {
public int member1;
[SoapFieldAttribute(XmlElementName="MyXmlElement")] public string member2;
public string member3;
public double member4;
// A field that is not serialized.
[NonSerialized()] public string member5;
public TestSimpleObject() {
member1 = 11;
member2 = "hello";
member3 = "hello";
member4 = 3.14159265;
member5 = "hello world!";
}
}
<Serializable(), SoapTypeAttribute(XmlNamespace := "MyXmlNamespace")> Public Class TestSimpleObject
Public member1 As Integer
<SoapFieldAttribute(XmlElementName := "MyXmlElement")> Public member2 As String
Public member3 As String
Public member4 As Double
' A field that is not serialized.
<NonSerialized()> Public member5 As String
Public Sub New()
member1 = 11
member2 = "hello"
member3 = "hello"
member4 = 3.14159265
member5 = "hello world!"
End Sub
End Class
Hinweise
Die Zielobjekte für das SoapFieldAttribute Attribut sind Objektfelder. Das attribut SoapFieldAttribute wird verwendet, um Informationen anzugeben, die steuern, wie das .NET Framework das SOAP-Drahtformat für Zielfelder generiert.
Konstruktoren
| Name | Beschreibung |
|---|---|
| SoapFieldAttribute() |
Erstellt eine Instanz der SoapFieldAttribute Klasse. |
Felder
| Name | Beschreibung |
|---|---|
| ProtXmlNamespace |
Der XML-Namespace, in den das Ziel des aktuellen SOAP-Attributs serialisiert wird. (Geerbt von SoapAttribute) |
| ReflectInfo |
Ein Spiegelungsobjekt, das von Attributklassen verwendet wird, die von der SoapAttribute Klasse abgeleitet sind, um XML-Serialisierungsinformationen festzulegen. (Geerbt von SoapAttribute) |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Embedded |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Typ während der SOAP-Serialisierung geschachtelt werden muss. (Geerbt von SoapAttribute) |
| Order |
Dient zum Abrufen oder Festlegen der Reihenfolge des aktuellen Feldattributes. |
| TypeId |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird ein eindeutiger Bezeichner für diese Attribute. (Geerbt von Attribute) |
| UseAttribute |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Ziel des aktuellen Attributs als XML-Attribut anstelle eines XML-Felds serialisiert wird. (Geerbt von SoapAttribute) |
| XmlElementName |
Dient zum Abrufen oder Festlegen des XML-Elementnamens des Felds, das SoapFieldAttribute im Attribut enthalten ist. |
| XmlNamespace |
Dient zum Abrufen oder Festlegen des XML-Namespacenamens. (Geerbt von SoapAttribute) |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Gibt einen Wert zurück, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| GetHashCode() |
Gibt den Hashcode für diesen instance zurück. (Geerbt von Attribute) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsDefaultAttribute() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, gibt an, ob der Wert dieser Instanz der Standardwert für die abgeleitete Klasse ist. (Geerbt von Attribute) |
| IsInteropXmlElement() |
Gibt einen Wert zurück, der angibt, ob das aktuelle Attribut Interop-XML-Elementwerte enthält. |
| Match(Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem angegebenen Objekt entspricht. (Geerbt von Attribute) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu. (Geerbt von Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Ruft die Typinformationen für ein Objekt ab, mit denen die Typinformationen für eine Schnittstelle abgerufen werden können. (Geerbt von Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1). (Geerbt von Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Bietet Zugriff auf Eigenschaften und Methoden, die von einem Objekt verfügbar gemacht werden. (Geerbt von Attribute) |