Bookmark.InsertDatabase Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Word

Sestavení:: Microsoft.Office.Tools.Word.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Načte data ze zdroje dat (například samostatný dokument Word Microsoft Office, list Aplikace Microsoft Office Excel nebo databáze Aplikace Microsoft Access) a vloží data jako tabulku místo Bookmark ovládacího prvku.

public 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);

abstract member InsertDatabase : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub InsertDatabase (Optional ByRef Format As Object, Optional ByRef Style As Object, Optional ByRef LinkToSource As Object, Optional ByRef Connection As Object, Optional ByRef SQLStatement As Object, Optional ByRef SQLStatement1 As Object, Optional ByRef PasswordDocument As Object, Optional ByRef PasswordTemplate As Object, Optional ByRef WritePasswordDocument As Object, Optional ByRef WritePasswordTemplate As Object, Optional ByRef DataSource As Object, Optional ByRef From As Object, Optional ByRef To As Object, Optional ByRef IncludeFields As Object)

Parametry

Format: Object

Formát uvedený v poli Formáty v dialogovém okně Automatický formát tabulky. Může to být libovolná konstanta WdTableFormat . U buněk v tabulce se ve výchozím nastavení použije ohraničení.

Style: Object

LinkToSource: Object

true vytvořit propojení mezi novou tabulkou a zdrojem dat.

Connection: Object

Oblast, ve které se má provést dotaz určený parametrem SQLStatement. Způsob určení rozsahu závisí na způsobu načítání dat. Příklad: Při načítání dat prostřednictvím rozhraní ODBC (Open Database Connectivity) zadáte připojovací řetězec. Při načítání dat z Aplikace Microsoft Office Excel pomocí dynamické výměny dat (DDE) zadáte pojmenovanou oblast nebo "Celá tabulka". Poznámka: Dynamická výměna dat (DDE) je starší technologie, která není zabezpečená. Pokud je to možné, použijte bezpečnější alternativu k DDE, například ole (object linking and embedding). Při načítání dat z Aplikace Microsoft Access zadáte slovo "Tabulka" nebo "Dotaz", za nímž následuje název tabulky nebo dotazu.

SQLStatement: Object

Volitelný řetězec dotazu, který načte podmnožinu dat v primárním zdroji dat, který se má vložit do dokumentu.

SQLStatement1: Object

Pokud je řetězec dotazu delší než 255 znaků, SQLStatement označí první část řetězce a SQLStatement1 druhou část.

PasswordDocument: Object

Heslo (pokud existuje) potřebné k otevření zdroje dat. (Viz poznámky níže)

PasswordTemplate: Object

Pokud je zdrojem dat dokument microsoft office Word, je tento argument heslo (pokud existuje) potřebné k otevření připojené šablony. (Viz poznámky níže)

WritePasswordDocument: Object

Heslo potřebné k uložení změn v dokumentu. (Viz poznámky níže)

WritePasswordTemplate: Object

Heslo potřebné k uložení změn v šabloně (Viz poznámky níže)

DataSource: Object

Cesta a název souboru zdroje dat.

From: Object

Číslo prvního datového záznamu v oblasti záznamů, které se mají vložit.

To: Object

Číslo posledního datového záznamu v oblasti záznamů, které se mají vložit.

IncludeFields: Object

true a zahrnout názvy polí ze zdroje dat do prvního řádku nové tabulky.

Příklady

Tento příklad vloží do Bookmark ovládacího prvku tabulku aplikace Microsoft Excel. Hodnota Styl (191) je kombinací čísel 1, 2, 4, 8, 16, 32 a 128. Tento příklad předpokládá, že máte sešit s názvem Data.xlsx uložený v kořenovém adresáři jazyka C s alespoň dvěma řádky dat na listu.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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.xlsx";

    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);
}

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.xlsx")

End Sub

Poznámky

V aplikacích nedoporučujeme používat pevně kódovaná hesla. Pokud je v postupu vyžadováno heslo, požádejte o heslo uživatele, uložte je v proměnné a proměnnou použijte ve svém kódu.

Nepoužívejte předdefinovaný přihlašovací účet správce systému (sa). Místo toho udělte správcům systému členy pevné role serveru sysadmin a požádejte je, aby k přihlášení používali vlastní účty. Sa používejte pouze v případě, že neexistuje jiný způsob přihlášení. Pokud chcete zabránit neoprávněnému přístupu prostřednictvím přihlašovacího účtu sa, měli byste ho přiřadit silné a jedinečné heslo.

Pokud je to možné, použijte ověřování Systému Windows (označované také jako důvěryhodné připojení), které používá uživatelský účet Systému Windows pro připojení k SQL Server. Když se uživatel připojí prostřednictvím uživatelského účtu Windows, SQL Server použije informace v operačním systému Windows k ověření názvu účtu a hesla. Před použitím ověřování systému Windows musí správce serveru nakonfigurovat SQL Server pro použití tohoto režimu ověřování. Pokud ověřování systému Windows není k dispozici, vyhněte se ukládání přihlašovacích údajů uživatelů. Pro uživatele je bezpečnější zadávat své přihlašovací údaje při každém přihlášení.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.

Platí pro

Sdílet prostřednictvím