SoapAttributes.SoapElement Eigenschaft
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.
Ruft das zu überschreibende SoapElementAttribute ab oder legt dieses fest.
public:
property System::Xml::Serialization::SoapElementAttribute ^ SoapElement { System::Xml::Serialization::SoapElementAttribute ^ get(); void set(System::Xml::Serialization::SoapElementAttribute ^ value); };C#
public System.Xml.Serialization.SoapElementAttribute? SoapElement { get; set; }C#
public System.Xml.Serialization.SoapElementAttribute SoapElement { get; set; }member this.SoapElement : System.Xml.Serialization.SoapElementAttribute with get, setPublic Property SoapElement As SoapElementAttributeDas zu überschreibende SoapElementAttribute.
Im folgenden Beispiel wird eine Klasse namens Transportationserialisiert. Die Serialisierung des Vehicle Felds wird überschrieben. In der CreateOverrideSerializer -Methode wird ein SoapAttributeOverrides erstellt, und für jedes überschriebene Element oder jede überschriebene Enumeration wird ein SoapAttributes mit dem entsprechenden Eigenschaftensatz erstellt und dem SoapAttributeOverrideshinzugefügt. Ein XmlTypeMapping wird mit SoapAttributeOverrideserstellt, das verwendet wird, XmlTypeMapping um die zu erstellen, die XmlSerializer die Standardserialisierung außer Kraft setzt.
#using <System.Xml.dll>
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml::Serialization;
using namespace System::Collections;
using namespace System::Xml;
using namespace System::Text;
public ref class Thing
{
public:
[SoapElement(IsNullable=true)]
String^ ThingName;
};
public ref class Transportation
{
public:
// The SoapElementAttribute specifies that the
// generated XML element name will be S"Wheels"
// instead of S"Vehicle".
[SoapElement("Wheels")]
String^ Vehicle;
[SoapElement(DataType="dateTime")]
DateTime CreationDate;
[SoapElement(IsNullable=true)]
Thing^ thing;
};
public ref class Test
{
public:
// Return an XmlSerializer used for overriding.
XmlSerializer^ CreateSoapOverrider()
{
// Create the SoapAttributes and SoapAttributeOverrides objects.
SoapAttributes^ soapAttrs = gcnew SoapAttributes;
SoapAttributeOverrides^ soapOverrides = gcnew SoapAttributeOverrides;
// Create an SoapElementAttribute to the Vehicles property.
SoapElementAttribute^ soapElement1 = gcnew SoapElementAttribute( "Truck" );
// Set the SoapElement to the Object*.
soapAttrs->SoapElement = soapElement1;
// Add the SoapAttributes to the SoapAttributeOverrides,specifying the member to.
soapOverrides->Add( Transportation::typeid, "Vehicle", soapAttrs );
// Create the XmlSerializer, and return it.
XmlTypeMapping^ myTypeMapping = (gcnew SoapReflectionImporter( soapOverrides ))->ImportTypeMapping( Transportation::typeid );
return gcnew XmlSerializer( myTypeMapping );
}
void SerializeOverride( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = CreateSoapOverrider();
// Create the Object* and serialize it.
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
void SerializeObject( String^ filename )
{
// Create an XmlSerializer instance.
XmlSerializer^ ser = gcnew XmlSerializer( Transportation::typeid );
Transportation^ myTransportation = gcnew Transportation;
myTransportation->Vehicle = "MyCar";
myTransportation->CreationDate = DateTime::Now;
myTransportation->thing = gcnew Thing;
XmlTextWriter^ writer = gcnew XmlTextWriter( filename,Encoding::UTF8 );
writer->Formatting = Formatting::Indented;
writer->WriteStartElement( "wrapper" );
ser->Serialize( writer, myTransportation );
writer->WriteEndElement();
writer->Close();
}
};
int main()
{
Test^ t = gcnew Test;
t->SerializeObject( "SoapElementOriginal.xml" );
t->SerializeOverride( "SoapElementOverride.xml" );
Console::WriteLine( "Finished writing two XML files." );
}
C#
using System;
using System.IO;
using System.Xml.Serialization;
using System.Collections;
using System.Xml;
using System.Text;
public class Transportation
{
// The SoapElementAttribute specifies that the
// generated XML element name will be "Wheels"
// instead of "Vehicle".
[SoapElement("Wheels")]
public string Vehicle;
[SoapElement(DataType = "dateTime")]
public DateTime CreationDate;
[SoapElement(IsNullable = true)]
public Thing thing;
}
public class Thing{
[SoapElement(IsNullable=true)] public string ThingName;
}
public class Test
{
public static void Main()
{
Test t = new Test();
t.SerializeObject("SoapElementOriginal.xml");
t.SerializeOverride("SoapElementOverride.xml");
Console.WriteLine("Finished writing two XML files.");
}
// Return an XmlSerializer used for overriding.
public XmlSerializer CreateSoapOverrider()
{
// Create the SoapAttributes and SoapAttributeOverrides objects.
SoapAttributes soapAttrs = new SoapAttributes();
SoapAttributeOverrides soapOverrides =
new SoapAttributeOverrides();
/* Create an SoapElementAttribute to override
the Vehicles property. */
SoapElementAttribute soapElement1 =
new SoapElementAttribute("Truck");
// Set the SoapElement to the object.
soapAttrs.SoapElement= soapElement1;
/* Add the SoapAttributes to the SoapAttributeOverrides,
specifying the member to override. */
soapOverrides.Add(typeof(Transportation), "Vehicle", soapAttrs);
// Create the XmlSerializer, and return it.
XmlTypeMapping myTypeMapping = (new SoapReflectionImporter
(soapOverrides)).ImportTypeMapping(typeof(Transportation));
return new XmlSerializer(myTypeMapping);
}
public void SerializeOverride(string filename)
{
// Create an XmlSerializer instance.
XmlSerializer ser = CreateSoapOverrider();
// Create the object and serialize it.
Transportation myTransportation =
new Transportation();
myTransportation.Vehicle = "MyCar";
myTransportation.CreationDate=DateTime.Now;
myTransportation.thing = new Thing();
XmlTextWriter writer =
new XmlTextWriter(filename, Encoding.UTF8);
writer.Formatting = Formatting.Indented;
writer.WriteStartElement("wrapper");
ser.Serialize(writer, myTransportation);
writer.WriteEndElement();
writer.Close();
}
public void SerializeObject(string filename){
// Create an XmlSerializer instance.
XmlSerializer ser = new XmlSerializer(typeof(Transportation));
Transportation myTransportation =
new Transportation();
myTransportation.Vehicle = "MyCar";
myTransportation.CreationDate = DateTime.Now;
myTransportation.thing = new Thing();
XmlTextWriter writer =
new XmlTextWriter(filename, Encoding.UTF8);
writer.Formatting = Formatting.Indented;
writer.WriteStartElement("wrapper");
ser.Serialize(writer, myTransportation);
writer.WriteEndElement();
writer.Close();
}
}
Imports System.IO
Imports System.Xml.Serialization
Imports System.Collections
Imports System.Xml
Imports System.Text
Public Class Transportation
' The SoapElementAttribute specifies that the
' generated XML element name will be "Wheels"
' instead of "Vehicle".
<SoapElement("Wheels")> Public Vehicle As String
<SoapElement(DataType:= "dateTime")> _
public CreationDate As DateTime
<SoapElement(IsNullable:= true)> _
public thing As Thing
End Class
Public Class Thing
<SoapElement(IsNullable:=true)> public ThingName As string
End Class
Public Class Test
Shared Sub Main()
Dim t As Test = New Test()
t.SerializeObject("SoapElementOriginalVb.xml")
t.SerializeOverride("SoapElementOverrideVb.xml")
Console.WriteLine("Finished writing two XML files.")
End Sub
' Return an XmlSerializer used for overriding.
Public Function CreateSoapOverrider() As XmlSerializer
' Create the SoapAttributes and SoapAttributeOverrides objects.
Dim soapAttrs As SoapAttributes = New SoapAttributes()
Dim soapOverrides As SoapAttributeOverrides = _
New SoapAttributeOverrides()
' Create a SoapElementAttribute to override
' the Vehicles property.
Dim soapElement1 As SoapElementAttribute = _
New SoapElementAttribute("Truck")
' Set the SoapElement to the object.
soapAttrs.SoapElement= soapElement1
' Add the SoapAttributes to the SoapAttributeOverrides,
' specifying the member to override.
soapOverrides.Add(GetType(Transportation), "Vehicle", soapAttrs)
' Create the XmlSerializer, and return it.
Dim myTypeMapping As XmlTypeMapping = (New _
SoapReflectionImporter (soapOverrides)).ImportTypeMapping _
(GetType(Transportation))
return New XmlSerializer(myTypeMapping)
End Function
Public Sub SerializeOverride(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = CreateSoapOverrider()
' Create the object and serialize it.
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate = DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
New XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
Public Sub SerializeObject(filename As String)
' Create an XmlSerializer instance.
Dim ser As XmlSerializer = _
New XmlSerializer(GetType(Transportation))
Dim myTransportation As Transportation = _
New Transportation()
myTransportation.Vehicle = "MyCar"
myTransportation.CreationDate=DateTime.Now
myTransportation.thing= new Thing()
Dim writer As XmlTextWriter = _
new XmlTextWriter(filename, Encoding.UTF8)
writer.Formatting = Formatting.Indented
writer.WriteStartElement("wrapper")
ser.Serialize(writer, myTransportation)
writer.WriteEndElement()
writer.Close()
End Sub
End Class
Wird SoapElementAttribute verwendet, um die Serialisierung eines Klassenmembers als XML-Element zu steuern. Legen Sie die SoapElement -Eigenschaft auf ein neues SoapElementAttribute fest, um die Serialisierung eines Klassenmembers als XML-Element zu überschreiben, indem Sie ein neues SoapElementAttribute erstellen und der Eigenschaft zuweisen. Fügen Sie dann zu SoapAttributes einer SoapAttributeOverrideshinzu. Erstellen Sie mit XmlTypeMappingSoapAttributeOverrides, und erstellen Sie dann mit XmlSerializerXmlTypeMapping.
Weitere Informationen finden Sie in der SoapAttributeOverrides Klassenübersicht.
| Produkt | Versionen |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Feedback zu .NET
.NET ist ein Open Source-Projekt. Wählen Sie einen Link aus, um Feedback zu geben: