Saml2SecurityTokenHandler.WriteAssertion Method
[Starting with the .NET Framework 4.5, Windows Identity Foundation (WIF) has been fully integrated into the .NET Framework. The version of WIF addressed by this topic, WIF 3.5, is deprecated and should only be used when developing against the .NET Framework 3.5 SP1 or the .NET Framework 4. For more information about WIF in the .NET Framework 4.5, also known as WIF 4.5, see the Windows Identity Foundation documentation in the .NET Framework 4.5 Development Guide.]
Serializes the specified SAML assertion to the specified XML writer.
Namespace: Microsoft.IdentityModel.Tokens.Saml2
Assembly: Microsoft.IdentityModel (in Microsoft.IdentityModel.dll)
Usage
'Usage
Dim writer As XmlWriter
Dim data As Saml2Assertion
Me.WriteAssertion(writer, data)
Syntax
'Declaration
Protected Overridable Sub WriteAssertion ( _
writer As XmlWriter, _
data As Saml2Assertion _
)
protected virtual void WriteAssertion (
XmlWriter writer,
Saml2Assertion data
)
protected:
virtual void WriteAssertion (
XmlWriter^ writer,
Saml2Assertion^ data
)
protected void WriteAssertion (
XmlWriter writer,
Saml2Assertion data
)
protected function WriteAssertion (
writer : XmlWriter,
data : Saml2Assertion
)
Parameters
- writer
The XmlWriter to use for the serialization.
- data
A Saml2Assertion that represents the assertion to serialize.
Exceptions
| Exception type | Condition |
|---|---|
| ArgumentNullException | writer is null. -or- data is null. |
| InvalidOperationException | The assertion specified by data has both the EncryptingCredentials and ReceivedEncryptingCredentials properties set to null. -or- There are no statements and no subject in the assertion specified by data. (Both the Subject property and the Statements property are null.) If an assertion does not contain statements, it must contain a subject. -or- The assertion specified by data contains an authentication, attribute, or authorization decision statement and no subject—these statements require a subject. (The Statements property contains a statement of type Saml2AttributeStatement, Saml2AuthenticationStatement, or Saml2AuthorizationDecisionStatement and the Subject property is null). |
| CryptographicException | The token encrypting credentials do not have a Symmetric Key specified. |
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Platforms
Target Platforms
Windows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)
See Also
Reference
Saml2SecurityTokenHandler Class
Saml2SecurityTokenHandler Members
Microsoft.IdentityModel.Tokens.Saml2 Namespace
Copyright © 2008 by Microsoft Corporation. All rights reserved.