DataObject 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.
Stellt das Objektelement einer XML-Signatur dar, das zu signierende Daten enthält.
public ref class DataObject
public class DataObject
type DataObject = class
Public Class DataObject
- Vererbung
-
DataObject
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie eine umhüllende XML-Signatur generiert wird.
#using <System.dll>
#using <System.Xml.dll>
#using <System.Security.dll>
using namespace System;
using namespace System::IO;
using namespace System::Security::Cryptography;
using namespace System::Security::Cryptography::Xml;
using namespace System::Xml;
int main()
{
// Create example data to sign.
XmlDocument^ document = gcnew XmlDocument;
XmlNode^ node = document->CreateNode( XmlNodeType::Element, "", "MyElement", "samples" );
node->InnerText = "This is some text";
document->AppendChild( node );
Console::Error->WriteLine( "Data to sign:\n{0}\n", document->OuterXml );
// Create the SignedXml message.
SignedXml^ signedXml = gcnew SignedXml;
RSA^ key = RSA::Create();
signedXml->SigningKey = key;
// Create a data object to hold the data to sign.
DataObject^ dataObject = gcnew DataObject;
dataObject->Data = document->ChildNodes;
dataObject->Id = "MyObjectId";
// Add the data object to the signature.
signedXml->AddObject( dataObject );
// Create a reference to be able to package everything into the
// message.
Reference^ reference = gcnew Reference;
reference->Uri = "#MyObjectId";
// Add it to the message.
signedXml->AddReference( reference );
// Add a KeyInfo.
KeyInfo^ keyInfo = gcnew KeyInfo;
keyInfo->AddClause( gcnew RSAKeyValue( key ) );
signedXml->KeyInfo = keyInfo;
// Compute the signature.
signedXml->ComputeSignature();
// Get the XML representation of the signature.
XmlElement^ xmlSignature = signedXml->GetXml();
Console::WriteLine( xmlSignature->OuterXml );
}
using System;
using System.IO;
using System.Security.Cryptography;
using System.Security.Cryptography.Xml;
using System.Xml;
public class XMLdsigsample1 {
static void Main(String[] args)
{
// Create example data to sign.
XmlDocument document = new XmlDocument();
XmlNode node = document.CreateNode(XmlNodeType.Element, "", "MyElement", "samples");
node.InnerText = "This is some text";
document.AppendChild(node);
Console.Error.WriteLine("Data to sign:\n" + document.OuterXml + "\n");
// Create the SignedXml message.
SignedXml signedXml = new SignedXml();
RSA key = RSA.Create();
signedXml.SigningKey = key;
// Create a data object to hold the data to sign.
DataObject dataObject = new DataObject();
dataObject.Data = document.ChildNodes;
dataObject.Id = "MyObjectId";
// Add the data object to the signature.
signedXml.AddObject(dataObject);
// Create a reference to be able to package everything into the
// message.
Reference reference = new Reference();
reference.Uri = "#MyObjectId";
// Add it to the message.
signedXml.AddReference(reference);
// Add a KeyInfo.
KeyInfo keyInfo = new KeyInfo();
keyInfo.AddClause(new RSAKeyValue(key));
signedXml.KeyInfo = keyInfo;
// Compute the signature.
signedXml.ComputeSignature();
// Get the XML representation of the signature.
XmlElement xmlSignature = signedXml.GetXml();
Console.WriteLine(xmlSignature.OuterXml);
}
}
Imports System.IO
Imports System.Security.Cryptography
Imports System.Security.Cryptography.Xml
Imports System.Xml
_
Public Class XMLdsigsample1
Shared Sub Main(args() As [String])
' Create example data to sign.
Dim document As New XmlDocument()
Dim node As XmlNode = document.CreateNode(XmlNodeType.Element, "", "MyElement", "samples")
node.InnerText = "This is some text"
document.AppendChild(node)
Console.Error.WriteLine("Data to sign:")
Console.Error.WriteLine()
Console.Error.WriteLine(document.OuterXml)
Console.Error.WriteLine()
' Create the SignedXml message.
Dim signedXml As New SignedXml()
Dim key As RSA = RSA.Create()
signedXml.SigningKey = key
' Create a data object to hold the data to sign.
Dim dataObject As New DataObject()
dataObject.Data = document.ChildNodes
dataObject.Id = "MyObjectId"
' Add the data object to the signature.
signedXml.AddObject(dataObject)
' Create a reference to be able to package everything into the
' message.
Dim reference As New Reference()
reference.Uri = "#MyObjectId"
' Add it to the message.
signedXml.AddReference(reference)
' Add a KeyInfo.
Dim keyInfo As New KeyInfo()
keyInfo.AddClause(New RSAKeyValue(key))
signedXml.KeyInfo = keyInfo
' Compute the signature.
signedXml.ComputeSignature()
' Get the XML representation of the signature.
Dim xmlSignature As XmlElement = signedXml.GetXml()
Console.WriteLine(xmlSignature.OuterXml)
End Sub
End Class
Im folgenden Codebeispiel wird veranschaulicht, wie eine XML-Signatur überprüft wird.
#using <System.dll>
#using <System.Security.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::Security::Cryptography;
using namespace System::Security::Cryptography::Xml;
using namespace System::IO;
using namespace System::Xml;
int main()
{
array<String^>^args = System::Environment::GetCommandLineArgs();
Console::WriteLine( "Verifying {0}...", args[ 1 ] );
// Create a SignedXml.
SignedXml^ signedXml = gcnew SignedXml;
// Load the XML.
XmlDocument^ xmlDocument = gcnew XmlDocument;
xmlDocument->PreserveWhitespace = true;
xmlDocument->Load( gcnew XmlTextReader( args[ 1 ] ) );
XmlNodeList^ nodeList = xmlDocument->GetElementsByTagName( "Signature" );
signedXml->LoadXml( safe_cast<XmlElement^>(nodeList[ 0 ]) );
if ( signedXml->CheckSignature() )
{
Console::WriteLine( "Signature check OK" );
}
else
{
Console::WriteLine( "Signature check FAILED" );
}
}
using System;
using System.Security.Cryptography;
using System.Security.Cryptography.Xml;
using System.IO;
using System.Xml;
public class Verify {
public static void Main(String[] args)
{
Console.WriteLine("Verifying " + args[0] + "...");
// Create a SignedXml.
SignedXml signedXml = new SignedXml();
// Load the XML.
XmlDocument xmlDocument = new XmlDocument();
xmlDocument.PreserveWhitespace = true;
xmlDocument.Load(new XmlTextReader(args[0]));
XmlNodeList nodeList = xmlDocument.GetElementsByTagName("Signature");
signedXml.LoadXml((XmlElement)nodeList[0]);
if (signedXml.CheckSignature()) {
Console.WriteLine("Signature check OK");
} else {
Console.WriteLine("Signature check FAILED");
}
}
}
Imports System.Security.Cryptography
Imports System.Security.Cryptography.Xml
Imports System.IO
Imports System.Xml
_
Public Class Verify
Public Shared Sub Main(args() As [String])
Console.WriteLine(("Verifying " + args(0) + "..."))
' Create a SignedXml.
Dim signedXml As New SignedXml()
' Load the XML.
Dim xmlDocument As New XmlDocument()
xmlDocument.PreserveWhitespace = True
xmlDocument.Load(New XmlTextReader(args(0)))
Dim nodeList As XmlNodeList = xmlDocument.GetElementsByTagName("Signature")
signedXml.LoadXml(CType(nodeList(0), XmlElement))
If signedXml.CheckSignature() Then
Console.WriteLine("Signature check OK")
Else
Console.WriteLine("Signature check FAILED")
End If
End Sub
End Class
Hinweise
Verwenden Sie die DataObject -Klasse, um Informationen oder Metadaten direkt in einer XML-Signatur zu speichern. Sie können z. B. das Signaturgenerierungsdatum oder die Identität des Unterzeichners speichern. Die DataObject -Klasse kann von der XML-Signatur abgedeckt werden oder nicht.
Die -Klasse entspricht dem <Object>
Element in der W3C-Spezifikation (World Wide Web Consortium) für XML-Signaturen. Weitere Informationen zur W3C-Spezifikation finden Sie unter https://www.w3.org/TR/xmldsig-core/.
Konstruktoren
DataObject() |
Initialisiert eine neue Instanz der DataObject-Klasse. |
DataObject(String, String, String, XmlElement) |
Initialisiert eine neue Instanz der DataObject-Klasse mit der angegebenen ID, dem MIME-Typ, der Codierung und den Daten. |
Eigenschaften
Data |
Ruft den Datenwert des aktuellen DataObject-Objekts ab oder legt diesen fest. |
Encoding |
Ruft die Codierung des aktuellen DataObject-Objekts ab oder legt diese fest. |
Id |
Ruft die ID des aktuellen DataObject-Objekts ab oder legt diese fest. |
MimeType |
Ruft den MIME-Typ des aktuellen DataObject-Objekts ab oder legt diesen fest. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
GetXml() |
Gibt die XML-Darstellung des DataObject-Objekts zurück. |
LoadXml(XmlElement) |
Lädt einen DataObject-Zustand aus einem XML-Element. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |