WorkbookBase.XmlImport أسلوب

مقالة
09/21/2010

قم باستيراد بيانات XML ملف في مصنف الحالي.

مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel.v4.0.Utilities (في Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

بناء الجملة

'إقرار
Public Function XmlImport ( _
    url As String, _
    <OutAttribute> ByRef importMap As XmlMap, _
    overwrite As Object, _
    destination As Object _
) As XlXmlImportResult

public XlXmlImportResult XmlImport(
    string url,
    out XmlMap importMap,
    Object overwrite,
    Object destination
)

المعلمات

url
النوع: System.String
مورد منتظم محدد موقع (المعلومات URL) أو مسار اصطلاح (UNC) تسمية موحد لبيانات XML ملف.

importMap
النوع: Microsoft.Office.Interop.Excel.XmlMap%
تعيين المخطط لتطبيقه عند استيراد ملف.

overwrite
النوع: System.Object
إذا كانت القيمة هو غير محدد ل Destinationمعلمة، ثم th هو تعين معلمة أو عدم الكتابة فوق بيانات التي يتم تعيين إلى مخطط المخطط المحدد في ImportMapمعلمة.التعيين إلى trueالكتابة فوق البيانات موجود أو falseلإلحاق بيانات جديدة إلى البيانات موجود.القيمة الافتراضية هي true.إذا كانت القيمة هو المحددة ل Destinationمعلمة، ثم th هو تعين معلمة أو عدم الكتابة فوق بيانات exهوting.قم بتعيين trueالكتابة فوق بيانات موجود أو falseإلى إلغاء الأمر استيراد إذا قد تتم الكتابة فوق بيانات.القيمة الافتراضية هي true.

destination
النوع: System.Object
سيتم استيراد بيانات إلى قائمة XML جديد في Rangeالمحدد.

القيمة المُرجعة

النوع: Microsoft.Office.Interop.Excel.XlXmlImportResult
واحد XlXmlImportResultقيم.

ملاحظات

لا تقم بتحديد القيمة ل Destinationمعلمة إذا كنت تريد في استيراد البيانات في في موجودة التعيين.

الشروط التالية سيؤدي هذا الأسلوب إلى إنشاء أخطاء وقت التشغيل:

بيانات XML المحدد يحتوي على أخطاء في بناء الجملة.
تم الإلغاء عملية استيراد بسبب تعذر احتواء بيانات المحددة في ورقة عمل.

استخدام XmlImportXmlأسلوب في استيراد بيانات XML التي تم تم تحميله سابقا في في ذاكرة.

المعلمات الإختيارية

ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.

أمثلة

إنشاء مثال التعليمة البرمجية التالية XmlMapاستناداً إلى مخطط تم إنشاؤه من DataSet، يكتب DataSetإلى ملف XML، ثم يستخدم XmlImportأسلوب لكتابة بيانات في ملف XML إلى نطاق في ورقة عمل Sheet1.

Th هو المثال هو لتخصيص المستوى مستند.

Private Sub WorkbookXmlImport()

    ' Create a new DataTable.
    Dim ds As New DataSet()
    Dim dt As DataTable = ds.Tables.Add("Customers")
    dt.Columns.Add(New DataColumn("LastName"))
    dt.Columns.Add(New DataColumn("FirstName"))

    ' Add a new row to the DataTable.
    Dim dr As DataRow = dt.NewRow()
    dr("LastName") = "Chan"
    dr("FirstName") = "Gareth"
    dt.Rows.Add(dr)

    ' Add a new XML map and write the XML to a file.
    Dim xmlMap1 As Excel.XmlMap = Me.XmlMaps.Add(ds.GetXmlSchema(), _
        "NewDataSet")
    ds.WriteXml("C:\Customers.xml")

    ' Import the XML from the file.
    Dim range1 As Excel.Range = Globals.Sheet1.Range("A1")
    Me.XmlImport("C:\Customers.xml", xmlMap1, True, _
        range1)
End Sub

private void WorkbookXmlImport()
{
    // Create a new DataTable.
    DataSet ds = new DataSet();
    DataTable dt = ds.Tables.Add("Customers");
    dt.Columns.Add(new DataColumn("LastName"));
    dt.Columns.Add(new DataColumn("FirstName"));

    // Add a new row to the DataTable.
    DataRow dr = dt.NewRow();
    dr["LastName"] = "Chan";
    dr["FirstName"] = "Gareth";
    dt.Rows.Add(dr);

    // Add a new XML map and write the XML to a file.
    Excel.XmlMap xmlMap1 = this.XmlMaps.Add(ds.GetXmlSchema(),
        "NewDataSet");
    ds.WriteXml(@"C:\Customers.xml");

    // Import the XML from the file.
    Excel.Range range1 = Globals.Sheet1.Range["A1", missing];
    this.XmlImport(@"C:\Customers.xml", out xmlMap1, true, range1);
}

أمن NET Framework.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.