Bookmark.InsertDatabase 메서드

아티클
08/10/2011

데이터 소스(예: 별도의 Microsoft Office Word 문서, Microsoft Office Excel 워크시트 또는 Microsoft Access 데이터베이스)에서 데이터를 검색한 다음 Bookmark 컨트롤 대신에 해당 데이터를 표로 삽입합니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
Sub InsertDatabase ( _
    ByRef Format As Object, _
    ByRef Style As Object, _
    ByRef LinkToSource As Object, _
    ByRef Connection As Object, _
    ByRef SQLStatement As Object, _
    ByRef SQLStatement1 As Object, _
    ByRef PasswordDocument As Object, _
    ByRef PasswordTemplate As Object, _
    ByRef WritePasswordDocument As Object, _
    ByRef WritePasswordTemplate As Object, _
    ByRef DataSource As Object, _
    ByRef From As Object, _
    ByRef To As Object, _
    ByRef IncludeFields As Object _
)

void InsertDatabase(
    ref Object Format,
    ref Object Style,
    ref Object LinkToSource,
    ref Object Connection,
    ref Object SQLStatement,
    ref Object SQLStatement1,
    ref Object PasswordDocument,
    ref Object PasswordTemplate,
    ref Object WritePasswordDocument,
    ref Object WritePasswordTemplate,
    ref Object DataSource,
    ref Object From,
    ref Object To,
    ref Object IncludeFields
)

매개 변수

Format
형식: System.Object%
표 자동 서식 대화 상자의 서식 상자에 나열된 서식입니다.WdTableFormat 상수 중 하나일 수 있습니다.테두리는 기본적으로 표의 셀에 적용됩니다.

Style
형식: System.Object%
표에 적용되는 Format에 지정된 자동 서식의 특성입니다.다음 값을 임의로 조합한 합계를 사용합니다.
[1|1] 값
[1|2] 의미
[2|1] 0(영)
[2|2] 없음
[3|1] 1
[3|2] 테두리
[4|1] 2
[4|2] 음영
[5|1] 4
[5|2] 글꼴
[6|1] 8
[6|2] 색상
[7|1] 16
[7|2] 자동 맞춤
[8|1] 32
[8|2] 제목 행
[9|1] 64
[9|2] 마지막 행
[10|1] 128
[10|2] 첫 번째 열
[11|1] 256
[11|2] 마지막 열

LinkToSource
형식: System.Object%
새 표와 데이터 소스 사이의 연결을 설정하려면 true입니다.

Connection
형식: System.Object%
SQLStatement에 의해 지정된 쿼리를 수행할 범위입니다.범위를 지정하는 방법은 데이터 검색 방법에 따라 달라집니다.예를 들면 다음과 같습니다.
ODBC(Open Database Connectivity)를 통해 데이터를 검색할 경우 연결 문자열을 지정합니다.
DDE(동적 데이터 교환)를 사용하여 Microsoft Office Excel에서 데이터를 검색할 경우 명명된 범위 또는 "전체 스프레드시트"를 지정합니다.
편지지 DDE(동적 데이터 교환)는 안전하지 않은 구식 기술입니다.가능하면 OLE(Object Linking and Embedding)와 같이 DDE보다 안전한 기술을 사용합니다.
Microsoft Access에서 데이터를 검색할 경우 "Table" 또는 "Query" 다음에 테이블 또는 쿼리 이름을 지정합니다.

SQLStatement
형식: System.Object%
기본 데이터 소스에서 문서에 삽입될 데이터의 하위 집합을 검색하는 선택적 쿼리 문자열입니다.

SQLStatement1
형식: System.Object%
쿼리 문자열이 255자보다 길면 SQLStatement는 문자열의 첫 번째 부분을 나타내고 SQLStatement1은 두 번째 부분을 나타냅니다.

PasswordDocument
형식: System.Object%
데이터 소스를 여는 데 필요한 암호(있는 경우)입니다.아래 설명을 참조하십시오.

PasswordTemplate
형식: System.Object%
데이터 소스가 Microsoft Office Word 문서인 경우 이 인수는 연결된 템플릿을 여는 데 필요한 암호(있는 경우)입니다.아래 설명을 참조하십시오.

WritePasswordDocument
형식: System.Object%
문서에 대한 변경 사항을 저장하는 데 필요한 암호입니다.아래 설명을 참조하십시오.

WritePasswordTemplate
형식: System.Object%
템플릿에 대한 변경 사항을 저장하는 데 필요한 암호입니다.아래 설명을 참조하십시오.

DataSource
형식: System.Object%
데이터 소스의 경로와 파일 이름입니다.

From
형식: System.Object%
삽입될 레코드 범위의 첫 번째 데이터 레코드 번호입니다.

To
형식: System.Object%
삽입될 레코드 범위의 마지막 데이터 레코드 번호입니다.

IncludeFields
형식: System.Object%
데이터 소스의 필드 이름을 새 표의 첫 번째 행에 포함하려면 true입니다.

설명

응용 프로그램에서 하드 코드된 암호를 사용하지 마십시오. 프로시저에서 암호가 필요하면 사용자에게 암호를 요청하여 변수에 저장한 후 코드에서 해당 변수를 사용합니다.

기본 제공 SA(시스템 관리자) 로그온 계정을 사용하지 마십시오. 대신 시스템 관리자를 sysadmin 고정 서버 역할의 멤버로 만들고 자신의 계정을 사용하여 로그온하도록 합니다. 다른 로그온 방법이 없는 경우에만 SA를 사용합니다. SA 로그온 계정을 통한 무단 액세스를 방지하려면 해당 계정에 강력한 고유 암호를 할당해야 합니다.

가능하면 트러스트된 연결이라고도 하는 Windows 인증을 사용합니다. 이 인증에서는 Windows 사용자 계정을 사용하여 SQL Server에 연결합니다. 사용자가 Windows 사용자 계정을 통해 연결할 경우 SQL Server에서는 Windows 운영 체제의 정보를 사용하여 계정 이름과 암호를 확인합니다. Windows 인증을 사용하려면 서버 관리자는 우선 이러한 인증 모드를 사용하도록 SQL Server를 구성해야 합니다. Windows 인증을 사용할 수 없으면 사용자의 로그온 정보를 저장하지 마십시오. 사용자가 로그온할 때마다 로그온 정보를 입력하는 것이 더욱 안전합니다.

선택적 매개 변수

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

예제

이 예제에서는 Microsoft Excel 스프레드시트를 Bookmark 컨트롤에 삽입합니다. 스타일 값(191)은 숫자 1, 2, 4, 8, 16, 32 및 128의 조합입니다. 이 예제에서는 C 드라이브의 루트에 저장된 Data.xls라는 통합 문서가 있고, 워크시트에 두 개 이상의 데이터 행이 있다고 가정합니다.

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

Private Sub BookmarkInsertDatabase()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.Text = "This is sample bookmark text"
    Bookmark1.InsertDatabase(Format:=Word.WdTableFormat _
        .wdTableFormatClassic1, Style:=191, LinkToSource:=False, _
        Connection:="Entire Spreadsheet", DataSource:="C:\Data.xls")

End Sub

private void BookmarkInsertDatabase()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text";

    object Format = Word.WdTableFormat.wdTableFormatClassic1;
    object Style = 191;
    object LinkToSource = false;
    object Connection = "Entire Spreadsheet";
    object DataSource = "C:\\Data.xls";

    bookmark1.InsertDatabase(ref Format, ref Style, ref LinkToSource,
        ref Connection, ref missing, ref missing, ref missing,
        ref missing, ref missing, ref missing, ref DataSource,
        ref missing, ref missing, ref missing);
}

.NET Framework 보안

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

참고 항목

참조

Bookmark 인터페이스

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

다음을 통해 공유

Bookmark.InsertDatabase 메서드

구문

매개 변수

설명

선택적 매개 변수

예제

.NET Framework 보안

참고 항목

참조

추가 리소스