XmlSchemaCollection.Add 方法

定義

命名空間:

System.Xml.Schema

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

將給定的結構加入結構集合中。

多載

名稱	Description
Add(XmlSchema)	將 加入 XmlSchema 收藏。
Add(XmlSchemaCollection)	將該集合中定義的所有命名空間（包括其對應結構）加入此集合。
Add(String, String)	將該 URL 所在的結構加入結構集合中。
Add(String, XmlReader)	將 中 XmlReader 包含的結構加入結構集合。
Add(XmlSchema, XmlResolver)	將 加入 XmlSchema 收藏。 指定 XmlResolver 用來解析任何外部參考。
Add(String, XmlReader, XmlResolver)	將 中 XmlReader 包含的結構加入結構集合。 指定 XmlResolver 用來解析任何外部資源。

備註

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

Add(XmlSchema)

來源:

XmlSchemaCollection.cs

將 加入 XmlSchema 收藏。

public:
 System::Xml::Schema::XmlSchema ^ Add(System::Xml::Schema::XmlSchema ^ schema);

public System.Xml.Schema.XmlSchema? Add(System.Xml.Schema.XmlSchema schema);

member this.Add : System.Xml.Schema.XmlSchema -> System.Xml.Schema.XmlSchema

Public Function Add (schema As XmlSchema) As XmlSchema

參數

schema

XmlSchema

XmlSchema加入收藏。

傳回

XmlSchema

XmlSchema 物件。

備註

屬性 targetNamespace 用來識別此結構。

如果新增的結構包含對其他命名空間（透過 include 和 import 元素）的參考，應用程式的信任等級決定了這些其他命名空間的解析方式。 （在 .NET Framework 1.0 版本中，預設值 XmlUrlResolver 始終使用。）

Fully trusted code: 預設且 XmlUrlResolver 無使用者憑證可用來解析任何外部資源。 這些其他命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。 如果這些外部資源位於需要認證的網路資源上，請使用一個以 為 XmlResolver 參數之一的超載，並指定 a XmlResolver 並指定必要的憑證。

Semi-trusted code: 外部參考尚未解決。

備註

如果是用屬性XmlValidatingReader.Schemas存取，XmlSchemaCollection方法Add則使用屬性XmlValidatingReader.XmlResolver指定的。XmlResolver

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

另請參閱

• XmlSchema

Add(XmlSchemaCollection)

來源:

XmlSchemaCollection.cs

將該集合中定義的所有命名空間（包括其對應結構）加入此集合。

public:
 void Add(System::Xml::Schema::XmlSchemaCollection ^ schema);

public void Add(System.Xml.Schema.XmlSchemaCollection schema);

member this.Add : System.Xml.Schema.XmlSchemaCollection -> unit

Public Sub Add (schema As XmlSchemaCollection)

參數

schema

XmlSchemaCollection

XmlSchemaCollection你想加入這個收藏。

備註

若新增的結構包含對其他命名空間的引用（透過 include 和 import 元素或屬性）， x-schema 應用程式的信任等級決定如何解析這些其他命名空間。 （在 .NET Framework 1.0 版本中，預設值 XmlUrlResolver 始終使用。）

Fully trusted code: 預設且 XmlUrlResolver 無使用者憑證可用來解析任何外部資源。 這些其他命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。 如果這些外部資源位於需要認證的網路資源上，請使用一個以 為 XmlResolver 參數之一的超載，並指定 a XmlResolver 並指定必要的憑證。

Semi-trusted code: 外部參考尚未解決。

備註

如果是用屬性XmlValidatingReader.Schemas存取，XmlSchemaCollection方法Add則使用屬性XmlValidatingReader.XmlResolver指定的。XmlResolver

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

Add(String, String)

來源:

XmlSchemaCollection.cs

將該 URL 所在的結構加入結構集合中。

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::String ^ uri);

public System.Xml.Schema.XmlSchema? Add(string? ns, string uri);

member this.Add : string * string -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, uri As String) As XmlSchema

參數

ns

String

與結構相關的 URI 命名空間。 對於 XML 結構，通常會是 targetNamespace。

uri

String

指定要載入的結構的網址。

傳回

XmlSchema

XmlSchema將被加入結構集合;null若被新增的結構是 XDR 架構，或結構中存在編譯錯誤。

例外狀況

XmlException

這個結構本身就不是有效的結構。

備註

如果 ns 已經與集合中的另一個結構關聯，所新增的結構會取代集合中的原始結構。 例如，在以下 C# 程式碼中，authors.xsd 會從集合中移除，並新增 names.xsd。

schemaColl.Add("urn:author", "authors.xsd");
schemaColl.Add("urn:author", "names.xsd");

若 ns 且 null 新增的結構是 XML 架構， Add 該方法會利用 targetNamespace XML 架構中定義的 來識別集合中的結構。 若新增的結構包含對其他命名空間的引用（透過 include 和 import 元素或屬性）， x-schema 應用程式的信任等級決定如何解析這些其他命名空間。 （在 .NET Framework 1.0 版本中，預設值 XmlUrlResolver 始終使用。）

Fully trusted code: 預設且 XmlUrlResolver 無使用者憑證可用來解析任何外部資源。 這些其他命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。 如果這些外部資源位於需要認證的網路資源上，請使用一個以 為 XmlResolver 參數之一的超載，並指定 a XmlResolver 並指定必要的憑證。

Semi-trusted code: 外部參考尚未解決。

備註

如果是用屬性XmlValidatingReader.Schemas存取，XmlSchemaCollection方法Add則使用屬性XmlValidatingReader.XmlResolver指定的。XmlResolver

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

Add(String, XmlReader)

來源:

XmlSchemaCollection.cs

將 中 XmlReader 包含的結構加入結構集合。

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::Xml::XmlReader ^ reader);

public System.Xml.Schema.XmlSchema? Add(string? ns, System.Xml.XmlReader reader);

member this.Add : string * System.Xml.XmlReader -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, reader As XmlReader) As XmlSchema

參數

ns

String

與結構相關的 URI 命名空間。 對於 XML 結構，通常會是 targetNamespace。

reader

XmlReader

XmlReader 包含該模式以補充。

傳回

XmlSchema

XmlSchema將被加入結構集合;null若被新增的結構是 XDR 架構，或結構中存在編譯錯誤。

例外狀況

XmlException

這個結構本身就不是有效的結構。

備註

如果 ns 已經與集合中的另一個結構關聯，所新增的結構會取代集合中的原始結構。

若 ns 且 null 新增的結構是 XML 架構， Add 該方法會利用 targetNamespace XML 架構中定義的 來識別集合中的結構。

若新增的結構包含對其他命名空間的引用（透過 include 和 import 元素或屬性）， x-schema 應用程式的信任等級決定如何解析這些其他命名空間。 （在 .NET Framework 1.0 版本中，預設值 XmlUrlResolver 始終使用。）

Fully trusted code: 預設且 XmlUrlResolver 無使用者憑證可用來解析任何外部資源。 這些其他命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。 如果這些外部資源位於需要認證的網路資源上，請使用一個以 為 XmlResolver 參數之一的超載，並指定 a XmlResolver 並指定必要的憑證。

Semi-trusted code: 外部參考尚未解決。

備註

如果是用屬性XmlValidatingReader.Schemas存取，XmlSchemaCollection方法Add則使用屬性XmlValidatingReader.XmlResolver指定的。XmlResolver

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

Add(XmlSchema, XmlResolver)

來源:

XmlSchemaCollection.cs

將 加入 XmlSchema 收藏。 指定 XmlResolver 用來解析任何外部參考。

public:
 System::Xml::Schema::XmlSchema ^ Add(System::Xml::Schema::XmlSchema ^ schema, System::Xml::XmlResolver ^ resolver);

public System.Xml.Schema.XmlSchema? Add(System.Xml.Schema.XmlSchema schema, System.Xml.XmlResolver? resolver);

member this.Add : System.Xml.Schema.XmlSchema * System.Xml.XmlResolver -> System.Xml.Schema.XmlSchema

Public Function Add (schema As XmlSchema, resolver As XmlResolver) As XmlSchema

參數

schema

XmlSchema

XmlSchema加入收藏。

resolver

XmlResolver

它們XmlResolver用來解析在 和 import 元素中include引用的命名空間。 若為 null，則外部參考不會被解析。

傳回

XmlSchema

他們 XmlSchema 加入了結構集合。

例外狀況

XmlException

這個結構本身就不是有效的結構。

備註

屬性 targetNamespace 用來識別此結構。

若結構包含 include 及 import 參考其他命名空間的元素，則這些其他命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。

這很重要

該 XmlSchemaCollection 級別已過時，已被該級別取代 XmlSchemaSet 。

另請參閱

• Credentials
• NetworkCredential
• CredentialCache

Add(String, XmlReader, XmlResolver)

來源:

XmlSchemaCollection.cs

將 中 XmlReader 包含的結構加入結構集合。 指定 XmlResolver 用來解析任何外部資源。

public:
 System::Xml::Schema::XmlSchema ^ Add(System::String ^ ns, System::Xml::XmlReader ^ reader, System::Xml::XmlResolver ^ resolver);

public System.Xml.Schema.XmlSchema? Add(string? ns, System.Xml.XmlReader reader, System.Xml.XmlResolver? resolver);

member this.Add : string * System.Xml.XmlReader * System.Xml.XmlResolver -> System.Xml.Schema.XmlSchema

Public Function Add (ns As String, reader As XmlReader, resolver As XmlResolver) As XmlSchema

參數

ns

String

與結構相關的 URI 命名空間。 對於 XML 結構，通常會是 targetNamespace。

reader

XmlReader

XmlReader 包含該模式以補充。

resolver

XmlResolver

它們XmlResolver用於解析 和 import 元素或x-schema屬性（XDR 架構）中所include參考的命名空間。 若為 null，則外部參考不會被解析。

傳回

XmlSchema

XmlSchema將被加入結構集合;null若被新增的結構是 XDR 架構，或結構中存在編譯錯誤。

例外狀況

XmlException

這個結構本身就不是有效的結構。

備註

如果 ns 已經與集合中的另一個結構關聯，所新增的結構會取代集合中的原始結構。

若 ns 且 null 新增的結構是 XML 架構， Add 該方法會使用 targetNamespace XML 架構中定義的屬性來識別集合中的結構。

如果新增的結構包含對其他命名空間的參考（透過 include 和 import 元素或屬性）， x-schema 這些命名空間的結構僅用於驗證目的。 與原始結構不同，這些其他結構不會被明確加入結構集合中。 因此，這些資料無法透過任何收集方法或屬性被存取。

這很重要

該 XmlSchemaCollection 類別在 .NET Framework 2.0 版本中已過時，並被該 XmlSchemaSet 類別取代。

另請參閱

• Credentials
• NetworkCredential
• CredentialCache