연습: Word 작업창의 컨트롤에 데이터 바인딩

아티클
06/19/2023

이 연습에서는 Word의 작업창에 있는 컨트롤에 대한 데이터 바인딩을 보여 줍니다. 컨트롤은 SQL Server 데이터베이스의 테이블 간 마스터/세부 관계를 보여 줍니다.

적용 대상: 이 항목의 정보는 Word용 문서 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

이 연습에서는 다음 작업을 수행합니다.

데이터에 바인딩된 Windows Forms 컨트롤을 사용하여 작업창을 만듭니다.
마스터/세부 정보 관계를 사용하여 컨트롤에 데이터를 표시합니다.
애플리케이션이 열릴 때 작업창을 표시합니다.

참고 항목

일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio IDE 개인 설정을 참조하세요.

필수 조건

이 연습을 완료하려면 다음과 같은 구성 요소가 필요합니다.

Microsoft Office 개발자 도구를 포함하는 Visual Studio 버전입니다. 자세한 내용은 Office 솔루션을 개발하기 위한 컴퓨터 구성을 참조하세요.
Word 2013 또는 Word 2010.
Northwind SQL Server 샘플 데이터베이스가 있는 서버에 액세스합니다.
SQL Server 데이터베이스에서 읽고 쓸 수 있는 권한입니다.

프로젝트 만들기

첫 번째 단계에서는 Word 문서 프로젝트를 만듭니다.

새 프로젝트를 만들려면

My Word Actions Pane라는 Word 문서 프로젝트를 만듭니다. 마법사에서 새 문서 만들기를 선택합니다.

자세한 내용은 방법: Visual Studio에서 Office 프로젝트 만들기를 참조하세요.

Visual Studio의 디자이너에서 새 Word 문서가 열리고 My Word Actions Pane 프로젝트가 솔루션 탐색기에 추가됩니다.

작업 창에 컨트롤 추가

이 연습에서는 데이터에 바인딩된 Windows Forms 컨트롤을 포함하는 작업창 컨트롤이 필요합니다. 프로젝트에 데이터 원본을 추가한 다음, 데이터 원본 창에서 작업창 컨트롤로 컨트롤을 끕니다.

작업창 컨트롤을 추가하려면

솔루션 탐색기에서 My Word Actions Pane 프로젝트를 선택합니다.
프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
새 항목 추가 대화 상자에서 작업창 컨트롤을 선택하고 이름을 ActionsControl로 지정한 다음, 추가를 클릭합니다.

프로젝트에 데이터 원본을 추가하려면

데이터 원본 창이 표시되지 않으면 메뉴 모음에서 보기>다른 창>데이터 원본을 선택하여 이 창을 표시합니다.

참고 항목

데이터 원본 표시를 사용할 수 없는 경우 Word 문서를 클릭한 다음, 다시 확인합니다.
새 데이터 원본 추가를 클릭하여 데이터 원본 구성 마법사를 시작합니다.
데이터베이스를 선택하고 다음을 클릭합니다.
Northwind 샘플 SQL Server 데이터베이스에 대한 데이터 연결을 선택하거나 새 연결 단추를 사용하여 새 연결을 추가합니다.
다음을 클릭합니다.
연결을 저장하는 옵션을 선택한 경우 해당 옵션을 선택 취소하고 다음을 클릭합니다.
데이터베이스 개체 창에서 테이블 노드를 확장합니다.
Suppliers 및 Products 테이블 옆에 있는 확인란을 선택합니다.
Finish를 클릭합니다.

마법사는 Suppliers 테이블 및 Products 테이블을 데이터 원본 창에 추가합니다. 또한 솔루션 탐색기에 표시되는 형식화된 데이터 세트를 프로젝트에 추가합니다.

작업창 컨트롤에 데이터 바인딩된 Windows Forms 컨트롤을 추가하려면

데이터 소스 창에서 Suppliers 테이블을 확장합니다.
회사 이름 노드에서 드롭다운 화살표를 클릭한 다음, ComboBox를 클릭합니다.
데이터 원본 창에서 작업창 컨트롤로 CompanyName을 끌어옵니다.

ComboBox 컨트롤이 작업창 컨트롤에 만들어집니다. 동시에 SuppliersBindingSource라는 BindingSource, 테이블 어댑터, DataSet가 구성 요소 트레이의 프로젝트에 추가됩니다.
구성 요소 트레이에서 SuppliersBindingNavigator를 선택하고 삭제 키를 누릅니다. 이 연습에서는 SuppliersBindingNavigator를 사용하지 않습니다.

참고 항목

SuppliersBindingNavigator를 삭제해도 생성된 코드가 모두 제거되지는 않습니다. 이 코드를 제거할 수 있습니다.
콤보 상자를 레이블 아래로 이동하고 크기 속성을 171, 21로 변경합니다.
데이터 원본 창에서 Suppliers 테이블의 자식인 Products 테이블을 확장합니다.
ProductName 노드에서 드롭다운 화살표를 클릭하고 ListBox를 선택합니다.
ProductName을 작업창 컨트롤로 끌어다 놓습니다.

ListBox 컨트롤이 작업창 컨트롤에 만들어집니다. 동시에 ProductBindingSource라는 BindingSource, 테이블 어댑터가 구성 요소 트레이의 프로젝트에 추가됩니다.
목록 상자를 레이블 아래로 이동하고 크기 속성을 171,95로 변경합니다.
도구 상자에서 Button을 작업창 컨트롤로 끌어서 목록 상자 아래에 놓습니다.
Button에서 마우스 오른쪽 단추를 클릭하고 바로 가기 메뉴에서 속성을 클릭하여 다음 속성을 변경합니다.

속성 값

이름 삽입

Text 삽입
컨트롤에 맞게 사용자 정의 컨트롤의 크기를 조정합니다.

속성	값
이름	삽입
Text	삽입

데이터 원본 설정

데이터 원본을 설정하려면 작업창 컨트롤의 Load 이벤트에 코드를 추가하여 컨트롤을 DataTable의 데이터로 채우고, 각 컨트롤에 대해 DataSource 및 DataMember 속성을 설정합니다.

컨트롤에 데이터를 로드하려면

ActionsControl 클래스의 Load 이벤트 처리기에 다음 코드를 추가합니다.

private void ActionsControl_Load(object sender, EventArgs e)
{
    this.suppliersTableAdapter.Fill(this.northwindDataSet.Suppliers);
    this.productsTableAdapter.Fill(this.northwindDataSet.Products);
}

Private Sub ActionsControl_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    Me.SuppliersTableAdapter.Fill(Me.NorthwindDataSet.Suppliers)
    Me.ProductsTableAdapter.Fill(Me.NorthwindDataSet.Products)
End Sub

C#에서 이벤트 처리기를 Load 이벤트에 연결해야 합니다. ActionsControl 생성자에서 InitializeComponent 호출 다음에 이 코드를 배치할 수 있습니다. 이벤트 처리기를 만드는 방법에 대한 자세한 정보는 방법: Office 프로젝트에서 이벤트 처리기 만들기를 참조하세요.
```
this.Load += new EventHandler(ActionsControl_Load);
```

컨트롤의 데이터 바인딩 속성을 설정하려면

CompanyNameComboBox 컨트롤을 선택합니다.
속성 창에서 DataSource 속성 오른쪽에 있는 단추를 클릭하고 suppliersBindingSource를 선택합니다.
DisplayMember 속성의 오른쪽에 있는 단추를 클릭하고 CompanyName을 선택합니다.
DataBindings 속성을 확장하고 Text 속성 오른쪽의 단추를 클릭한 다음, None을 선택합니다.
ProductNameListBox 컨트롤을 선택합니다.
속성 창에서 DataSource 속성의 오른쪽에 있는 단추를 클릭하고 productsBindingSource를 선택합니다.
DisplayMember 속성의 오른쪽에 있는 단추를 클릭하고 ProductName을 선택합니다.
DataBindings 속성을 확장하고 SelectedValue 속성 오른쪽의 단추를 클릭한 다음, None을 선택합니다.

테이블에 데이터를 삽입하는 메서드 추가

다음 작업은 바인딩된 컨트롤에서 데이터를 읽고 Word 문서의 표를 채웁니다. 먼저 표의 머리글 서식을 지정하는 프로시저를 만든 다음, Word 표를 만들고 서식을 지정하는 AddData 메서드를 추가합니다.

표 머리글의 서식을 지정하려면

ActionsControl 클래스에서 테이블의 머리글 서식을 지정하는 메서드를 만듭니다.

static void SetHeadings(Microsoft.Office.Interop.Word.Cell tblCell, string text)
{
    tblCell.Range.Text = text;
    tblCell.Range.Font.Bold = 1;
    tblCell.Range.ParagraphFormat.Alignment = 
        Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphCenter;
}

Shared Sub SetHeadings(ByVal tblCell As Word.Cell, ByVal text As String)

    With tblCell.Range
        .Text = text
        .Font.Bold = True
        .ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter
    End With
End Sub

테이블을 만들려면

ActionsControl 클래스에서, 테이블이 없으면 테이블을 만드는 메서드를 작성하고 작업창의 데이터를 테이블에 추가합니다.

private void AddData(System.Data.DataRow row, string companyName)
{
    object missing = System.Type.Missing;

    // Create a table if it doesn't already exist.
    if (Globals.ThisDocument.Tables.Count == 0)
    {
        try
        {
            // Create a table.
            Microsoft.Office.Interop.Word.Table tbl = Globals.ThisDocument.Tables.Add
                (Globals.ThisDocument.Application.Selection.Range, 1, 4, ref missing, ref missing);

            // Insert headings.
            SetHeadings(tbl.Cell(1, 1), "Company Name");
            SetHeadings(tbl.Cell(1, 2), "Product Name");
            SetHeadings(tbl.Cell(1, 3), "Quantity");
            SetHeadings(tbl.Cell(1, 4), "Unit Price");
        }
        catch (Exception ex)
        {
            MessageBox.Show("Problem creating Products table: " + ex.Message, 
                "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }

    // Add data from data row to the table.
    Microsoft.Office.Interop.Word.Selection selection = Globals.ThisDocument.Application.Selection;

    if (selection.Tables.Count > 0)
    {
        Microsoft.Office.Interop.Word.Row newRow = Globals.ThisDocument.Tables[1].Rows.Add(ref missing);

        newRow.Range.Font.Bold = 0;

        newRow.Range.ParagraphFormat.Alignment = 
            Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphLeft;

        newRow.Cells[4].Range.ParagraphFormat.Alignment =
            Microsoft.Office.Interop.Word.WdParagraphAlignment.wdAlignParagraphRight;

        newRow.Cells[1].Range.Text = companyName;
        newRow.Cells[2].Range.Text = row["ProductName"].ToString();
        newRow.Cells[3].Range.Text = row["QuantityPerUnit"].ToString();
        newRow.Cells[4].Range.Text = Math.Round(Convert.ToDouble(row["UnitPrice"])).ToString("#,##0.00");
    }
    else
    {
        MessageBox.Show("Cursor must be within a table.", 
            "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error);
    }
}

Private Sub AddData(ByVal row As System.Data.DataRow, ByVal companyName As String)

    ' Create a table if it doesn't already exist.
    If Globals.ThisDocument.Tables.Count = 0 Then

        Try
            ' Create a table. 
            Dim tbl As Word.Table = Globals.ThisDocument.Tables.Add( _
                Globals.ThisDocument.Application.Selection.Range, 1, 4)

            ' Insert headings.
            SetHeadings(tbl.Cell(1, 1), "Company Name")
            SetHeadings(tbl.Cell(1, 2), "Product Name")
            SetHeadings(tbl.Cell(1, 3), "Quantity")
            SetHeadings(tbl.Cell(1, 4), "Unit Price")

        Catch ex As Exception
            MessageBox.Show("Problem creating Products table: " & ex.Message, _
                "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error)
        End Try
    End If

    ' Add data from data row to the table.
    Dim selection As Word.Selection = Globals.ThisDocument.Application.Selection

    If selection.Tables.Count > 0 Then

        Dim newRow As Word.Row = Globals.ThisDocument.Tables(1).Rows.Add()
        With newRow
            .Range.Font.Bold = False
            .Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphLeft
            .Cells(4).Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphRight
            .Cells(1).Range.Text = companyName
            .Cells(2).Range.Text = row.Item("ProductName").ToString
            .Cells(3).Range.Text = row.Item("QuantityPerUnit").ToString
            .Cells(4).Range.Text = Math.Round(row.Item("UnitPrice"), 2)
        End With

    Else
        MessageBox.Show("Cursor must be within a table.", _
            "Actions Pane", MessageBoxButtons.OK, MessageBoxIcon.Error)
    End If
End Sub

Word 표에 텍스트를 삽입하려면

삽입 단추의 Click 이벤트 처리기에 다음 코드를 추가합니다.

private void Insert_Click(object sender, System.EventArgs e)
{
    System.Data.DataTable tbl = northwindDataSet.Products;
    System.Data.DataRow[] rows;

    // Check if a product is selected.
    if (this.productNameListBox.SelectedIndex >= 0)
    {
        System.Data.DataRowView productRow = (System.Data.DataRowView)this.productNameListBox.SelectedItem;

        string product = productRow.Row["ProductName"].ToString();
        string company = this.companyNameComboBox.Text;

        // Return the data row from the selected product.
        rows = tbl.Select("[ProductName] = '" + product.Replace("'", "''") + "'");

        this.AddData(rows[0], company);
    }
    else
    {
        MessageBox.Show("Please select a product.", "Actions Pane", MessageBoxButtons.OK);
    }
}

Private Sub Insert_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Insert.Click

    Dim tbl As System.Data.DataTable = NorthwindDataSet.Products
    Dim rows() As System.Data.DataRow

    ' Check if a product is selected.
    If Not Me.ProductNameListBox.SelectedIndex < 0 Then

        Dim product As String = Me.ProductNameListBox.SelectedItem.Row.Item("ProductName")
        Dim company As String = Me.CompanyNameComboBox.Text

        ' Return the data row from the selected Product in the list box.
        rows = tbl.Select("[ProductName] = '" & product.Replace("'", "''") & "'")

        AddData(rows(0), company)

    Else
        MessageBox.Show("Please select a product.", "Actions Pane", MessageBoxButtons.OK)
    End If
End Sub

C#에서는 단추의 Click 이벤트에 대한 이벤트 처리기를 만들어야 합니다. 이 코드를 ActionsControl 클래스의 Load 이벤트 처리기에 배치할 수 있습니다.
```
this.Insert.Click += new EventHandler(Insert_Click);
```

작업 창 표시

컨트롤이 추가되면 작업창이 표시됩니다.

작업창을 표시하려면

솔루션 탐색기에서 ThisDocument.vb 또는 ThisDocument.cs를 마우스 오른쪽 단추로 클릭하고 코드 보기를 클릭합니다.
다음 예제와 같이 ThisDocument 클래스 맨 위에 컨트롤의 새 인스턴스를 만듭니다.
- C#
- VB
```
private ActionsControl actions = new ActionsControl();
```
```
Dim actions As New ActionsControl
```
다음 예제와 같이 ThisDocument의 Startup 이벤트 처리기에 코드를 추가합니다.
- C#
- VB
```
this.ActionsPane.Controls.Add(actions);
```
```
Me.ActionsPane.Controls.Add(actions)
```

애플리케이션 테스트

이제 문서를 테스트하여 문서를 열 때 작업창이 표시되는지 확인할 수 있습니다. 작업창의 컨트롤에서 마스터/세부 정보 관계를 테스트하고 삽입 단추를 클릭할 때 데이터가 Word 테이블에 채워지는지 확인합니다.

문서를 테스트하려면

F5 키를 눌러 프로젝트를 실행합니다.
작업 창이 표시되는지 확인합니다.
콤보 상자에서 회사를 선택하고 Products 목록 상자의 항목이 변경되었는지 확인합니다.
제품을 선택하고 작업창에서 삽입을 클릭한 다음, 제품 세부 정보가 Word의 표에 추가되었는지 확인합니다.
다양한 회사의 추가 제품을 삽입합니다.

다음 단계

이 연습에서는 Word의 작업창에서 컨트롤에 데이터를 바인딩하는 기본 사항을 보여 줍니다. 다음으로 수행할 수 있는 몇 가지 작업은 다음과 같습니다.

Excel에서 컨트롤에 데이터 바인딩. 자세한 정보는 연습: Excel 작업창의 컨트롤에 데이터 바인딩을 참조하세요.
프로젝트 배포. 자세한 내용은 ClickOnce를 사용하여 Office 솔루션 배포를 참조하세요.

다음을 통해 공유

연습: Word 작업창의 컨트롤에 데이터 바인딩

필수 조건

프로젝트 만들기

새 프로젝트를 만들려면

작업 창에 컨트롤 추가

작업창 컨트롤을 추가하려면

프로젝트에 데이터 원본을 추가하려면

작업창 컨트롤에 데이터 바인딩된 Windows Forms 컨트롤을 추가하려면

데이터 원본 설정

컨트롤에 데이터를 로드하려면

컨트롤의 데이터 바인딩 속성을 설정하려면

테이블에 데이터를 삽입하는 메서드 추가

표 머리글의 서식을 지정하려면

테이블을 만들려면

Word 표에 텍스트를 삽입하려면

작업 창 표시

작업창을 표시하려면

애플리케이션 테스트

문서를 테스트하려면

다음 단계

추가 리소스

다음을 통해 공유

연습: Word 작업창의 컨트롤에 데이터 바인딩

필수 조건

프로젝트 만들기

새 프로젝트를 만들려면

작업 창에 컨트롤 추가

작업창 컨트롤을 추가하려면

프로젝트에 데이터 원본을 추가하려면

작업창 컨트롤에 데이터 바인딩된 Windows Forms 컨트롤을 추가하려면

데이터 원본 설정

컨트롤에 데이터를 로드하려면

컨트롤의 데이터 바인딩 속성을 설정하려면

테이블에 데이터를 삽입하는 메서드 추가

표 머리글의 서식을 지정하려면

테이블을 만들려면

Word 표에 텍스트를 삽입하려면

작업 창 표시

작업창을 표시하려면

애플리케이션 테스트

문서를 테스트하려면

다음 단계

관련 콘텐츠

추가 리소스