This documentation is archived and is not being maintained.

Saml2SecurityTokenHandler.WriteAssertion Method

Windows Identity Foundation
[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)

Dim writer As XmlWriter
Dim data As Saml2Assertion

Me.WriteAssertion(writer, data)

protected virtual void WriteAssertion (
	XmlWriter writer,
	Saml2Assertion data
protected void WriteAssertion (
	XmlWriter writer, 
	Saml2Assertion data
protected function WriteAssertion (
	writer : XmlWriter, 
	data : Saml2Assertion



The XmlWriter to use for the serialization.


A Saml2Assertion that represents the assertion to serialize.

Exception typeCondition

writer is null.


data is null.


The assertion specified by data has both the EncryptingCredentials and ReceivedEncryptingCredentials properties set to null.


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.


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).


The token encrypting credentials do not have a Symmetric Key specified.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.


Target Platforms

Windows 7, Windows Server 2008 R2, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2003 SP2 (32-bit or 64-bit)

Copyright © 2008 by Microsoft Corporation. All rights reserved.