#region 程序集 mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
// C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.6.1\mscorlib.dll
#endregion
using System.Collections;
using System.Runtime.InteropServices;
namespace System.Security
{
//
// 摘要:
// 表示用于编码安全对象的 XML 对象模型。 此类不能被继承。
[ComVisible(true)]
public sealed class SecurityElement : ISecurityElementFactory
{
//
// 摘要:
// 新实例初始化 System.Security.SecurityElement 具有指定标记的类。
//
// 参数:
// tag:
// XML 元素的标记名称。
//
// 异常:
// T:System.ArgumentNullException:
// tag 参数为 null。
//
// T:System.ArgumentException:
// tag 参数是在 XML 中无效。
public SecurityElement(string tag);
//
// 摘要:
// 新实例初始化 System.Security.SecurityElement 类具有指定的标记和文本。
//
// 参数:
// tag:
// XML 元素的标记名称。
//
// text:
// 该元素内的文本内容。
//
// 异常:
// T:System.ArgumentNullException:
// tag 参数为 null。
//
// T:System.ArgumentException:
// tag 参数或 text 参数是在 XML 中无效。
public SecurityElement(string tag, string text);
//
// 摘要:
// 获取或设置 XML 元素的子元素的数组。
//
// 返回结果:
// 作为安全元素的 XML 元素的有序的子元素。
//
// 异常:
// T:System.ArgumentException:
// XML 父节点的子节点是 null。
public ArrayList Children { get; set; }
//
// 摘要:
// 获取或设置一个 XML 元素的属性作为名称/值对。
//
// 返回结果:
// System.Collections.Hashtable XML 元素的属性值的对象。
//
// 异常:
// T:System.InvalidCastException:
// 名称或值 System.Collections.Hashtable 对象无效。
//
// T:System.ArgumentException:
// 名称不是有效的 XML 属性名称。
public Hashtable Attributes { get; set; }
//
// 摘要:
// 获取或设置一个 XML 元素的标记名称。
//
// 返回结果:
// XML 元素的标记名称。
//
// 异常:
// T:System.ArgumentNullException:
// 标记是 null。
//
// T:System.ArgumentException:
// 标记不是在 XML 中无效的。
public string Tag { get; set; }
//
// 摘要:
// 获取或设置 XML 元素中的文本。
//
// 返回结果:
// 在 XML 元素文本的值。
//
// 异常:
// T:System.ArgumentException:
// 文本不是在 XML 中无效的。
public string Text { get; set; }
//
// 摘要:
// 替换无效的 XML 字符在字符串中使用其有效的 XML 等效项。
//
// 参数:
// str:
// 在其中进行转义的无效字符字符串。
//
// 返回结果:
// 输入的字符串与无效的字符替换。
public static string Escape(string str);
//
// 摘要:
// 从 XML 编码的字符串创建安全元素。
//
// 参数:
// xml:
// 从其创建安全元素的 XML 编码的字符串。
//
// 返回结果:
// 从 XML 创建的 System.Security.SecurityElement。
//
// 异常:
// T:System.Security.XmlSyntaxException:
// xml 包含一个或多个单引号字符。
//
// T:System.ArgumentNullException:
// xml 为 null。
public static SecurityElement FromString(string xml);
//
// 摘要:
// 确定字符串是否是有效的特性名。
//
// 参数:
// name:
// 要测试其有效性的属性名称。
//
// 返回结果:
// true 如果 name 参数是有效的 XML 属性名称; 否则为 false。
public static bool IsValidAttributeName(string name);
//
// 摘要:
// 确定字符串是否是有效的特性值。
//
// 参数:
// value:
// 要测试其有效性的属性值。
//
// 返回结果:
// true 如果 value 参数是有效的 XML 属性值; 否则为 false。
public static bool IsValidAttributeValue(string value);
//
// 摘要:
// 确定字符串是否是有效的标记。
//
// 参数:
// tag:
// 要测试其有效性的标记。
//
// 返回结果:
// true 如果 tag 参数是一个有效的 XML 标记; 否则为 false。
public static bool IsValidTag(string tag);
//
// 摘要:
// 确定字符串是否是有效 XML 元素中的文本。
//
// 参数:
// text:
// 要测试其有效性的文本。
//
// 返回结果:
// true 如果 text 参数都是有效的 XML 文本元素; 否则为 false。
public static bool IsValidText(string text);
//
// 摘要:
// 将名称/值特性添加到一个 XML 元素。
//
// 参数:
// name:
// 属性名。
//
// value:
// 属性的值。
//
// 异常:
// T:System.ArgumentNullException:
// name 参数或 value 参数是 null。
//
// T:System.ArgumentException:
// name 参数或 value 参数是在 XML 中无效。 - 或 - 具有指定的名称的属性 name 参数已存在。
public void AddAttribute(string name, string value);
//
// 摘要:
// 将子元素添加到 XML 元素。
//
// 参数:
// child:
// 要添加的子元素。
//
// 异常:
// T:System.ArgumentNullException:
// child 参数为 null。
public void AddChild(SecurityElement child);
//
// 摘要:
// 在一个 XML 元素按名称查找属性。
//
// 参数:
// name:
// 若要搜索的属性的名称。
//
// 返回结果:
// 与已命名特性关联的值或 null 如果无特性与 name 存在。
//
// 异常:
// T:System.ArgumentNullException:
// name 参数为 null。
public string Attribute(string name);
//
// 摘要:
// 创建并返回当前的相同副本 System.Security.SecurityElement 对象。
//
// 返回结果:
// 当前 System.Security.SecurityElement 对象的副本。
[ComVisible(false)]
public SecurityElement Copy();
//
// 摘要:
// 比较两个 XML 元素对象相等。
//
// 参数:
// other:
// XML 元素的当前 XML 元素对象进行比较的对象。
//
// 返回结果:
// true 标记、 特性名称和值、 子元素和当前的 XML 元素中的文本字段是与中的对应项相同 other 参数; 否则为 false。
public bool Equal(SecurityElement other);
//
// 摘要:
// 查找子级的标记名称。
//
// 参数:
// tag:
// 要搜索的子元素标记。
//
// 返回结果:
// 具有指定的标记值的第一个子 XML 元素或 null 如果没有子元素具有 tag 存在。
//
// 异常:
// T:System.ArgumentNullException:
// tag 参数为 null。
public SecurityElement SearchForChildByTag(string tag);
//
// 摘要:
// 查找子级的标记名称，并返回所包含的文本。
//
// 参数:
// tag:
// 要搜索的子元素标记。
//
// 返回结果:
// 具有指定的标记值的第一个子元素的文本内容。
//
// 异常:
// T:System.ArgumentNullException:
// tag 为 null。
public string SearchForTextOfTag(string tag);
//
// 摘要:
// 生成的字符串表示形式的 XML 元素及其构成特性、 子元素和文本。
//
// 返回结果:
// XML 元素，其内容。
public override string ToString();
}
}
