XmlSchemaSet.Reprocess(XmlSchema) Метод

Определение

Выполняет повторную обработку схемы языка определения схем XML (XSD), которая уже находится в XmlSchemaSet.Reprocesses an XML Schema definition language (XSD) schema that already exists in the XmlSchemaSet.

public:
 System::Xml::Schema::XmlSchema ^ Reprocess(System::Xml::Schema::XmlSchema ^ schema);
public System.Xml.Schema.XmlSchema Reprocess (System.Xml.Schema.XmlSchema schema);
member this.Reprocess : System.Xml.Schema.XmlSchema -> System.Xml.Schema.XmlSchema
Public Function Reprocess (schema As XmlSchema) As XmlSchema

Параметры

schema
XmlSchema

Схема, которую необходимо обработать повторно.The schema to reprocess.

Возвращаемое значение

Объект XmlSchema, если схема успешно прошла проверку.An XmlSchema object if the schema is a valid schema. Если схема не прошла проверку и задан ValidationEventHandler, тогда возвращается null и порождается соответствующее событие проверки.If the schema is not valid and a ValidationEventHandler is specified, null is returned and the appropriate validation event is raised. В противном случае возникает исключение XmlSchemaException.Otherwise, an XmlSchemaException is thrown.

Исключения

Схема не прошла проверку.The schema is not valid.

Объект XmlSchema, переданный в качестве параметра, является null.The XmlSchema object passed as a parameter is null.

Объект XmlSchema, передаваемый в качестве параметра, еще не существует в XmlSchemaSet.The XmlSchema object passed as a parameter does not already exist in the XmlSchemaSet.

Примеры

В следующем примере показана повторная обработка схемы, добавленной в XmlSchemaSet.The following example illustrates reprocessing a schema added to the XmlSchemaSet. После компиляции XmlSchemaSet с помощью метода Compile и изменения схемы, добавленной в XmlSchemaSet, свойству IsCompiled будет присвоено значение true, даже если схема в XmlSchemaSet была изменена.After the XmlSchemaSet is compiled using the Compile method, and the schema added to the XmlSchemaSet is modified, the IsCompiled property will be set to true, even though a schema in the XmlSchemaSet has been modified. Вызов метода Reprocess выполняет всю предварительную обработку, выполненную методом Add, и устанавливает для свойства IsCompiled значение false.Calling the Reprocess method performs all the preprocessing performed by the Add method and sets the IsCompiled property to false.

Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()  
Dim schema As XmlSchema = schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd")  
schemaSet.Compile()  
  
Dim element As XmlSchemaElement = New XmlSchemaElement()  
schema.Items.Add(element)  
element.Name = "book"  
element.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")  
  
schemaSet.Reprocess(schema)  
XmlSchemaSet schemaSet = new XmlSchemaSet();  
XmlSchema schema = schemaSet.Add("http://www.contoso.com/books", "http://www.contoso.com/books.xsd");  
schemaSet.Compile();  
  
XmlSchemaElement element = new XmlSchemaElement();  
schema.Items.Add(element);  
element.Name = "book";  
element.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");  
  
schemaSet.Reprocess(schema);  

Комментарии

Повторная обработка схемы выполняет все шаги предварительной обработки, выполненные в схеме при вызове метода Add.Reprocessing a schema performs all the preprocessing steps performed on a schema when the Add method is called. Если вызов Reprocess успешно выполнен, свойство IsCompiled устанавливается в значение false.If the call to Reprocess is successful, the IsCompiled property is set to false.

Метод повторной обработки следует использовать после того, как схема в XmlSchemaSet была изменена после того, как XmlSchemaSet выполнил компиляцию.The Reprocess method should be used after a schema in the XmlSchemaSet has been modified, after the XmlSchemaSet has performed compilation.

Примечание

Необходимо вызвать метод Reprocess, если вы изменили схему (или одну из ее включений или импортов) после ее добавления в XmlSchemaSet.You need to call the Reprocess method if you have changed a schema (or one of its includes/imports) after adding it to the XmlSchemaSet. Метод Reprocess проверит схему на наличие структурной достоверности в соответствии с правилами схемы W3C XML.The Reprocess method will check the schema for structural validity according to the rules of W3C XML Schema. Однако полная проверка не выполняется.However, it will not perform a full validation check. Он также будет разрешать ссылки на внутренние и внешние компоненты схемы.It will also resolve references to internal and external schema components. Все импортированные или включенные схемы, которые были успешно получены, также добавляются в XmlSchemaSet.Any imported or included schemas that are successfully retrieved are also added to the XmlSchemaSet. Импортированные схемы добавляются в виде отдельных объектов XmlSchema, тогда как включенные схемы входят в состав, включающий в себя XmlSchema.Imported schemas are added as separate XmlSchema objects while included schemas are made part of the including XmlSchema. Если вызов для повторной обработки выполнен успешно, свойству IsCompiled присваивается значение false.If the call to reprocess is successful, the IsCompiled property is set to false.

Применяется к