// SPUserNotice.cs
//
// XAdES Starter Kit for Microsoft .NET 3.5 (and above)
// 2010 Microsoft France
// Published under the CECILL-B Free Software license agreement.
// (http://www.cecill.info/licences/Licence_CeCILL-B_V1-en.txt)
//
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
// WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
// WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
// THE ENTIRE RISK OF USE OR RESULTS IN CONNECTION WITH THE USE OF THIS CODE
// AND INFORMATION REMAINS WITH THE USER.
using System;
using System.Security.Cryptography;
using System.Xml;
namespace Microsoft.Xades
{
///
/// SPUserNotice element is intended for being displayed whenever the
/// signature is validated. The class derives from SigPolicyQualifier.
///
public class SPUserNotice : SigPolicyQualifier
{
#region Private variables
private NoticeRef noticeRef;
private string explicitText;
#endregion
#region Public properties
///
/// The NoticeRef element names an organization and identifies by
/// numbers a group of textual statements prepared by that organization,
/// so that the application could get the explicit notices from a notices file
///
public NoticeRef NoticeRef
{
get
{
return this.noticeRef;
}
set
{
this.noticeRef = value;
}
}
///
/// The ExplicitText element contains the text of the notice to be displayed
///
public string ExplicitText
{
get
{
return this.explicitText;
}
set
{
this.explicitText = value;
}
}
///
/// Inherited generic element, not used in the SPUserNotice class
///
public override XmlElement AnyXmlElement
{
get
{
return null;
}
set
{
throw new CryptographicException("Setting AnyXmlElement on a SPUserNotice is not supported");
}
}
#endregion
#region Constructors
///
/// Default constructor
///
public SPUserNotice()
{
noticeRef = new NoticeRef();
}
#endregion
#region Public methods
///
/// Check to see if something has changed in this instance and needs to be serialized
///
/// Flag indicating if a member needs serialization
public override bool HasChanged()
{
bool retVal = false;
if (!String.IsNullOrEmpty(this.explicitText))
{
retVal = true;
}
if (this.noticeRef != null && this.noticeRef.HasChanged())
{
retVal = true;
}
return retVal;
}
///
/// Load state from an XML element
///
/// XML element containing new state
public override void LoadXml(System.Xml.XmlElement xmlElement)
{
XmlNamespaceManager xmlNamespaceManager;
XmlNodeList xmlNodeList;
if (xmlElement == null)
{
throw new ArgumentNullException("xmlElement");
}
xmlNamespaceManager = new XmlNamespaceManager(xmlElement.OwnerDocument.NameTable);
xmlNamespaceManager.AddNamespace("xsd", XadesSignedXml.XadesNamespaceUri);
xmlNodeList = xmlElement.SelectNodes("xsd:SPUserNotice/xsd:NoticeRef", xmlNamespaceManager);
if (xmlNodeList.Count != 0)
{
this.noticeRef = new NoticeRef();
this.noticeRef.LoadXml((XmlElement)xmlNodeList.Item(0));
}
xmlNodeList = xmlElement.SelectNodes("xsd:SPUserNotice/xsd:ExplicitText", xmlNamespaceManager);
if (xmlNodeList.Count != 0)
{
this.explicitText = xmlNodeList.Item(0).InnerText;
}
}
///
/// Returns the XML representation of the this object
///
/// XML element containing the state of this object
public override XmlElement GetXml()
{
XmlDocument creationXmlDocument;
XmlElement bufferXmlElement;
XmlElement bufferXmlElement2;
XmlElement retVal;
creationXmlDocument = new XmlDocument();
retVal = creationXmlDocument.CreateElement("xades", "SigPolicyQualifier", XadesSignedXml.XadesNamespaceUri);
bufferXmlElement = creationXmlDocument.CreateElement("xades", "SPUserNotice", XadesSignedXml.XadesNamespaceUri);
if (this.noticeRef != null && this.noticeRef.HasChanged())
{
bufferXmlElement.AppendChild(creationXmlDocument.ImportNode(this.noticeRef.GetXml(), true));
}
if (!String.IsNullOrEmpty(this.explicitText))
{
bufferXmlElement2 = creationXmlDocument.CreateElement("xades", "ExplicitText", XadesSignedXml.XadesNamespaceUri);
bufferXmlElement2.InnerText = this.explicitText;
bufferXmlElement.AppendChild(bufferXmlElement2);
}
retVal.AppendChild(creationXmlDocument.ImportNode(bufferXmlElement, true));
return retVal;
}
#endregion
}
}