다음을 통해 공유


WorkbookBase.XmlImport 메서드

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
    XML 데이터 파일에 대한 URL(Uniform Resource Locator) 또는 UNC(Uniform Naming Convention) 경로입니다.
  • overwrite
    형식: System.Object
    Destination 매개 변수에 대한 값이 지정되어 있지 않으면 이 매개 변수는 ImportMap 매개 변수로 지정된 스키마 맵에 매핑되어 있는 데이터를 덮어쓸지 여부를 지정합니다.데이터를 덮어쓰려면 true로 설정하고, 기존 데이터에 새 데이터를 추가하려면 false로 설정합니다.기본값은 true입니다.Destination 매개 변수에 대한 값이 지정되어 있으면 이 매개 변수에 따라 기존 데이터를 덮어쓸지 여부가 결정됩니다.기존 데이터를 덮어쓰려면 true로 설정하고, 데이터를 덮어쓰게 될 경우 가져오기를 취소하려면 false로 설정합니다.기본값은 true입니다.
  • destination
    형식: System.Object
    데이터를 새 XML 목록의 지정된 Range로 가져옵니다.

반환 값

형식: Microsoft.Office.Interop.Excel.XlXmlImportResult
XlXmlImportResult 값 중 하나입니다.

설명

데이터를 기존 매핑으로 가져오려면 Destination 매개 변수의 값을 지정하지 마십시오.

이 메서드는 다음과 같은 경우 런타임 오류를 생성합니다.

  • 지정된 XML 데이터에 구문 오류가 있는 경우

  • 지정한 데이터가 워크시트 크기에 맞지 않아서 가져오기 프로세스가 취소된 경우

메모리에 이미 로드된 XML 데이터를 가져오려면 XmlImportXml 메서드를 사용합니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하십시오.

예제

다음 코드 예제에서는 DataSet에서 생성된 스키마를 기반으로 XmlMap을 만들고 XML 파일에 DataSet을 쓴 다음 XmlImport 메서드를 사용하여 XML 파일의 데이터를 워크시트 Sheet1의 범위에 씁니다.

이 예제는 문서 수준 사용자 지정을 위한 것입니다.

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 보안

  • 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

WorkbookBase 클래스

Microsoft.Office.Tools.Excel 네임스페이스