// 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 } }