Code:
/ FXUpdate3074 / FXUpdate3074 / 1.1 / untmp / whidbey / QFE / ndp / fx / src / Xml / System / Xml / ValidateNames.cs / 1 / ValidateNames.cs
//------------------------------------------------------------------------------
//
// Copyright (c) Microsoft Corporation. All rights reserved.
//
// [....]
//-----------------------------------------------------------------------------
using System;
using System.Xml.XPath;
using System.Diagnostics;
namespace System.Xml {
///
/// Contains various static functions and methods for parsing and validating:
/// NCName (not namespace-aware, no colons allowed)
/// QName (prefix:local-name)
///
internal class ValidateNames {
// Not creatable
private ValidateNames() {
}
public enum Flags {
NCNames = 0x1, // Validate that each non-empty prefix and localName is a valid NCName
CheckLocalName = 0x2, // Validate the local-name
CheckPrefixMapping = 0x4, // Validate the prefix --> namespace mapping
All = 0x7,
AllExceptNCNames = 0x6,
AllExceptPrefixMapping = 0x3,
};
//-----------------------------------------------
// NCName parsing
//-----------------------------------------------
///
/// Attempts to parse the input string as an NCName (see the XML Namespace spec).
/// Quits parsing when an invalid NCName char is reached or the end of string is reached.
/// Returns the number of valid NCName chars that were parsed.
///
public static unsafe int ParseNCName(string s, int offset) {
int offsetStart = offset;
XmlCharType xmlCharType = XmlCharType.Instance;
Debug.Assert(s != null && offset <= s.Length);
// Quit if the first character is not a valid NCName starting character
if (offset < s.Length &&
(xmlCharType.charProperties[s[offset]] & XmlCharType.fNCStartName) != 0) { // xmlCharType.IsStartNCNameChar(s[offset])) {
// Keep parsing until the end of string or an invalid NCName character is reached
for (offset++; offset < s.Length; offset++) {
if ((xmlCharType.charProperties[s[offset]] & XmlCharType.fNCName) == 0) // if (!xmlCharType.IsNCNameChar(s[offset]))
break;
}
}
return offset - offsetStart;
}
///
/// Calls parseName and throws exception if the resulting name is not a valid NCName.
/// Returns the input string if there is no error.
///
public static string ParseNCNameThrow(string s) {
// throwOnError = true
ParseNCNameInternal(s, true);
return s;
}
///
/// Calls parseName and returns false or throws exception if the resulting name is not
/// a valid NCName. Returns the input string if there is no error.
///
private static bool ParseNCNameInternal(string s, bool throwOnError) {
int len = ParseNCName(s, 0);
if (len == 0 || len != s.Length) {
// If the string is not a valid NCName, then throw or return false
if (throwOnError) ThrowInvalidName(s, 0, len);
return false;
}
return true;
}
//-----------------------------------------------
// QName parsing
//-----------------------------------------------
///
/// Attempts to parse the input string as a QName (see the XML Namespace spec).
/// Quits parsing when an invalid QName char is reached or the end of string is reached.
/// Returns the number of valid QName chars that were parsed.
/// Sets colonOffset to the offset of a colon character if it exists, or 0 otherwise.
///
public static int ParseQName(string s, int offset, out int colonOffset) {
int len, lenLocal;
// Assume no colon
colonOffset = 0;
// Parse NCName (may be prefix, may be local name)
len = ParseNCName(s, offset);
if (len != 0) {
// Non-empty NCName, so look for colon if there are any characters left
offset += len;
if (offset < s.Length && s[offset] == ':') {
// First NCName was prefix, so look for local name part
lenLocal = ParseNCName(s, offset + 1);
if (lenLocal != 0) {
// Local name part found, so increase total QName length (add 1 for colon)
colonOffset = offset;
len += lenLocal + 1;
}
}
}
return len;
}
///
/// Calls parseQName and throws exception if the resulting name is not a valid QName.
/// Returns the prefix and local name parts.
///
public static void ParseQNameThrow(string s, out string prefix, out string localName) {
int colonOffset;
int len = ParseQName(s, 0, out colonOffset);
if (len == 0 || len != s.Length) {
// If the string is not a valid QName, then throw
ThrowInvalidName(s, 0, len);
}
if (colonOffset != 0) {
prefix = s.Substring(0, colonOffset);
localName = s.Substring(colonOffset + 1);
}
else {
prefix = "";
localName = s;
}
}
///
/// Parses the input string as a NameTest (see the XPath spec), returning the prefix and
/// local name parts. Throws an exception if the given string is not a valid NameTest.
/// If the NameTest contains a star, null values for localName (case NCName':*'), or for
/// both localName and prefix (case '*') are returned.
///
public static void ParseNameTestThrow(string s, out string prefix, out string localName) {
int len, lenLocal, offset;
if (s.Length != 0 && s[0] == '*') {
// '*' as a NameTest
prefix = localName = null;
len = 1;
}
else {
// Parse NCName (may be prefix, may be local name)
len = ParseNCName(s, 0);
if (len != 0) {
// Non-empty NCName, so look for colon if there are any characters left
localName = s.Substring(0, len);
if (len < s.Length && s[len] == ':') {
// First NCName was prefix, so look for local name part
prefix = localName;
offset = len + 1;
if (offset < s.Length && s[offset] == '*') {
// '*' as a local name part, add 2 to len for colon and star
localName = null;
len += 2;
}
else {
lenLocal = ParseNCName(s, offset);
if (lenLocal != 0) {
// Local name part found, so increase total NameTest length
localName = s.Substring(offset, lenLocal);
len += lenLocal + 1;
}
}
}
else {
prefix = string.Empty;
}
}
else {
// Make the compiler happy
prefix = localName = null;
}
}
if (len == 0 || len != s.Length) {
// If the string is not a valid NameTest, then throw
ThrowInvalidName(s, 0, len);
}
}
///
/// Throws an invalid name exception.
///
/// String that was parsed.
/// Offset in string where parsing began.
/// Offset in string where parsing failed.
public static void ThrowInvalidName(string s, int offsetStartChar, int offsetBadChar) {
// If the name is empty, throw an exception
if (offsetStartChar >= s.Length)
throw new XmlException(Res.Xml_EmptyName, string.Empty);
Debug.Assert(offsetBadChar < s.Length);
if (XmlCharType.Instance.IsNCNameChar(s[offsetBadChar]) && !XmlCharType.Instance.IsStartNCNameChar(s[offsetBadChar])) {
// The error character is a valid name character, but is not a valid start name character
throw new XmlException(Res.Xml_BadStartNameChar, XmlException.BuildCharExceptionStr(s[offsetBadChar]));
}
else {
// The error character is an invalid name character
throw new XmlException(Res.Xml_BadNameChar, XmlException.BuildCharExceptionStr(s[offsetBadChar]));
}
}
public static Exception GetInvalidNameException(string s, int offsetStartChar, int offsetBadChar) {
// If the name is empty, throw an exception
if (offsetStartChar >= s.Length)
return new XmlException(Res.Xml_EmptyName, string.Empty);
Debug.Assert(offsetBadChar < s.Length);
if (XmlCharType.Instance.IsNCNameChar(s[offsetBadChar]) && !XmlCharType.Instance.IsStartNCNameChar(s[offsetBadChar])) {
// The error character is a valid name character, but is not a valid start name character
return new XmlException(Res.Xml_BadStartNameChar, XmlException.BuildCharExceptionStr(s[offsetBadChar]));
}
else {
// The error character is an invalid name character
return new XmlException(Res.Xml_BadNameChar, XmlException.BuildCharExceptionStr(s[offsetBadChar]));
}
}
///
/// Returns true if "prefix" starts with the characters 'x', 'm', 'l' (case-insensitive).
///
public static bool StartsWithXml(string s) {
if (s.Length < 3)
return false;
if (s[0] != 'x' && s[0] != 'X')
return false;
if (s[1] != 'm' && s[1] != 'M')
return false;
if (s[2] != 'l' && s[2] != 'L')
return false;
return true;
}
///
/// Returns true if "s" is a namespace that is reserved by Xml 1.0 or Namespace 1.0.
///
public static bool IsReservedNamespace(string s) {
return s.Equals(XmlReservedNs.NsXml) || s.Equals(XmlReservedNs.NsXmlNs);
}
///
/// Throw if the specified name parts are not valid according to the rules of "nodeKind". Check only rules that are
/// specified by the Flags.
///
public static void ValidateNameThrow(string prefix, string localName, string ns, XPathNodeType nodeKind, Flags flags) {
// throwOnError = true
ValidateNameInternal(prefix, localName, ns, nodeKind, flags, true);
}
///
/// Return false if the specified name parts are not valid according to the rules of "nodeKind". Check only rules that are
/// specified by the Flags.
///
public static bool ValidateName(string prefix, string localName, string ns, XPathNodeType nodeKind, Flags flags) {
// throwOnError = false
return ValidateNameInternal(prefix, localName, ns, nodeKind, flags, false);
}
///
/// Return false or throw if the specified name parts are not valid according to the rules of "nodeKind". Check only rules
/// that are specified by the Flags.
///
private static bool ValidateNameInternal(string prefix, string localName, string ns, XPathNodeType nodeKind, Flags flags, bool throwOnError) {
Debug.Assert(prefix != null && localName != null && ns != null);
if ((flags & Flags.NCNames) != 0) {
// 1. Verify that each non-empty prefix and localName is a valid NCName
if (prefix.Length != 0)
if (!ParseNCNameInternal(prefix, throwOnError)) {
return false;
}
if (localName.Length != 0)
if (!ParseNCNameInternal(localName, throwOnError)) {
return false;
}
}
if ((flags & Flags.CheckLocalName) != 0) {
// 2. Determine whether the local name is valid
switch (nodeKind) {
case XPathNodeType.Element:
// Elements and attributes must have a non-empty local name
if (localName.Length == 0) {
if (throwOnError) throw new XmlException(Res.Xdom_Empty_LocalName, string.Empty);
return false;
}
break;
case XPathNodeType.Attribute:
// Attribute local name cannot be "xmlns" if namespace is empty
if (ns.Length == 0 && localName.Equals("xmlns")) {
if (throwOnError) throw new XmlException(Res.XmlBadName, new string[] {nodeKind.ToString(), localName});
return false;
}
goto case XPathNodeType.Element;
case XPathNodeType.ProcessingInstruction:
// PI's local-name must be non-empty and cannot be 'xml' (case-insensitive)
if (localName.Length == 0 || (localName.Length == 3 && StartsWithXml(localName))) {
if (throwOnError) throw new XmlException(Res.Xml_InvalidPIName, localName);
return false;
}
break;
default:
// All other node types must have empty local-name
if (localName.Length != 0) {
if (throwOnError) throw new XmlException(Res.XmlNoNameAllowed, nodeKind.ToString());
return false;
}
break;
}
}
if ((flags & Flags.CheckPrefixMapping) != 0) {
// 3. Determine whether the prefix is valid
switch (nodeKind) {
case XPathNodeType.Element:
case XPathNodeType.Attribute:
case XPathNodeType.Namespace:
if (ns.Length == 0) {
// If namespace is empty, then prefix must be empty
if (prefix.Length != 0) {
if (throwOnError) throw new XmlException(Res.Xml_PrefixForEmptyNs, string.Empty);
return false;
}
}
else {
// Don't allow empty attribute prefix since namespace is non-empty
if (prefix.Length == 0 && nodeKind == XPathNodeType.Attribute) {
if (throwOnError) throw new XmlException(Res.XmlBadName, new string[] {nodeKind.ToString(), localName});
return false;
}
if (prefix.Equals("xml")) {
// xml prefix must be mapped to the xml namespace
if (!ns.Equals(XmlReservedNs.NsXml)) {
if (throwOnError) throw new XmlException(Res.Xml_XmlPrefix, string.Empty);
return false;
}
}
else if (prefix.Equals("xmlns")) {
// Prefix may never be 'xmlns'
if (throwOnError) throw new XmlException(Res.Xml_XmlnsPrefix, string.Empty);
return false;
}
else if (IsReservedNamespace(ns)) {
// Don't allow non-reserved prefixes to map to xml or xmlns namespaces
if (throwOnError) throw new XmlException(Res.Xml_NamespaceDeclXmlXmlns, string.Empty);
return false;
}
}
break;
case XPathNodeType.ProcessingInstruction:
// PI's prefix and namespace must be empty
if (prefix.Length != 0 || ns.Length != 0) {
if (throwOnError) throw new XmlException(Res.Xml_InvalidPIName, CreateName(prefix, localName));
return false;
}
break;
default:
// All other node types must have empty prefix and namespace
if (prefix.Length != 0 || ns.Length != 0) {
if (throwOnError) throw new XmlException(Res.XmlNoNameAllowed, nodeKind.ToString());
return false;
}
break;
}
}
return true;
}
///
/// Creates a colon-delimited qname from prefix and local name parts.
///
private static string CreateName(string prefix, string localName) {
return (prefix.Length != 0) ? prefix + ":" + localName : localName;
}
///
/// Split a QualifiedName into prefix and localname, w/o any checking.
/// (Used for XmlReader/XPathNavigator MoveTo(name) methods)
///
internal static void SplitQName(string name, out string prefix, out string lname) {
int colonPos = name.IndexOf(':');
if (-1 == colonPos) {
prefix = string.Empty;
lname = name;
}
else if (0 == colonPos || (name.Length-1) == colonPos) {
throw new ArgumentException(Res.GetString(Res.Xml_BadNameChar, XmlException.BuildCharExceptionStr(':')), "name");
}
else {
prefix = name.Substring(0, colonPos);
colonPos++; // move after colon
lname = name.Substring(colonPos, name.Length - colonPos);
}
}
}
}
// File provided for Reference Use Only by Microsoft Corporation (c) 2007.
// Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- DictionaryEditChange.cs
- RSAOAEPKeyExchangeFormatter.cs
- MetadataItem_Static.cs
- EntityContainerRelationshipSetEnd.cs
- Activator.cs
- SchemaImporterExtensionElement.cs
- ScrollViewer.cs
- DateTimeValueSerializer.cs
- FieldToken.cs
- RotateTransform3D.cs
- LocatorManager.cs
- TextBounds.cs
- LoginName.cs
- GroupBox.cs
- Shape.cs
- TargetInvocationException.cs
- XmlSchemaSimpleType.cs
- DataGridViewSortCompareEventArgs.cs
- OdbcReferenceCollection.cs
- UnknownWrapper.cs
- EditingMode.cs
- ApplicationSecurityManager.cs
- ObjectParameter.cs
- FtpWebRequest.cs
- _UriTypeConverter.cs
- SqlStatistics.cs
- InvokeMethod.cs
- ToolStripItemImageRenderEventArgs.cs
- RijndaelCryptoServiceProvider.cs
- FileStream.cs
- PriorityRange.cs
- ContextMenuStrip.cs
- UnauthorizedAccessException.cs
- TemplateBindingExpression.cs
- SqlMethodAttribute.cs
- _NestedSingleAsyncResult.cs
- PtsCache.cs
- LayoutDump.cs
- Quad.cs
- HttpCacheVaryByContentEncodings.cs
- ProtocolsSection.cs
- TextTreeFixupNode.cs
- EntityClassGenerator.cs
- ItemChangedEventArgs.cs
- ObjectFullSpanRewriter.cs
- SmtpDigestAuthenticationModule.cs
- ComplexBindingPropertiesAttribute.cs
- WebPartConnectVerb.cs
- DataGridAddNewRow.cs
- TreeViewHitTestInfo.cs
- HealthMonitoringSectionHelper.cs
- SurrogateEncoder.cs
- RouteData.cs
- RTLAwareMessageBox.cs
- EndpointDiscoveryMetadata11.cs
- MessageDecoder.cs
- MemberInfoSerializationHolder.cs
- _HTTPDateParse.cs
- Typeface.cs
- VisualTreeHelper.cs
- GPRECTF.cs
- CodeAttributeArgument.cs
- ContainerUtilities.cs
- EntityViewGenerationAttribute.cs
- ParallelTimeline.cs
- SqlAggregateChecker.cs
- SettingsPropertyValueCollection.cs
- PreservationFileWriter.cs
- OpCopier.cs
- MenuTracker.cs
- DataProtection.cs
- Dispatcher.cs
- FieldNameLookup.cs
- XXXInfos.cs
- ValidationVisibilityAttribute.cs
- WebHttpBindingCollectionElement.cs
- FixedTextBuilder.cs
- CompilationPass2TaskInternal.cs
- ApplicationTrust.cs
- Rights.cs
- TemplateParser.cs
- TitleStyle.cs
- Mapping.cs
- ResourceAttributes.cs
- NetNamedPipeSecurityElement.cs
- TableCellAutomationPeer.cs
- EncoderParameter.cs
- Debug.cs
- DataServiceRequestOfT.cs
- RegexCharClass.cs
- JapaneseLunisolarCalendar.cs
- XmlnsPrefixAttribute.cs
- StyleSelector.cs
- RMEnrollmentPage1.cs
- AutomationPatternInfo.cs
- PhysicalOps.cs
- VectorValueSerializer.cs
- RelationshipType.cs
- IsolatedStoragePermission.cs
- PersonalizationEntry.cs