Connection クラス

リファレンス

定義

名前空間:: DocumentFormat.OpenXml.Spreadsheet

アセンブリ:: DocumentFormat.OpenXml.dll

アセンブリ:: DocumentFormat.OpenXml.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

接続します。オブジェクトを xml としてシリアル化されるときに、修飾名は、x: 接続です。

[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.DatabaseProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.OlapProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.WebQueryProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.TextProperties))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.Parameters))]
[DocumentFormat.OpenXml.ChildElementInfo(typeof(DocumentFormat.OpenXml.Spreadsheet.ConnectionExtensionList))]
public class Connection : DocumentFormat.OpenXml.OpenXmlCompositeElement

type Connection = class
    inherit OpenXmlCompositeElement

Public Class Connection
Inherits OpenXmlCompositeElement

継承: Object

OpenXmlElement

OpenXmlCompositeElement
Connection

属性: ChildElementInfoAttribute

注釈

[ISO/IEC 29500-1 1st Edition]

接続 (接続)

この要素には、外部データソースと同様に、ブック内の接続を使用する方法を説明する情報を取得する方法の両方の定義が含まれています。固有の構成要素は、OLAP の数式など、ワークシート、クエリテーブルで使用するか、ピボットテーブルが、既定のイベントまたはユーザーの明示的な要求に基づいて、情報を取得または更新データへの接続を使用します。

親要素
接続 (§18.13.2)

子要素	句
dbPr (データベースのプロパティ)	§18.13.3
extLst (将来機能のデータの記憶領域)	§18.2.10
olapPr (OLAP のプロパティ)	§18.13.5
パラメーター (クエリパラメーター)	§18.13.7
textPr (テキストのインポートの設定)	§18.13.12
webPr (Web クエリのプロパティ)	§18.13.13

属性	説明
背景 (バックグラウンドで更新)	かどうか、接続を更新できるバックグラウンド (非同期) を示します。バックグラウンドで非同期的に更新するのには、 true の場合は、接続の使用を推奨false接続の使用を優先する場合は、フォアグラウンドで同期的に更新するのには。このフラグは、特定のケースでは意図的に無視する必要があります。 [例: フラグは無視される場合の例は、両方のピボットテーブルとキューブ関数をブック内の接続が使用されている、Microsoft SQL Server Analysis Services の OLAP データへの接続します。接続は常に更新する同期的に、ピボットテーブルをキューブ関数を非同期的に更新されます常に。例終わり] この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
(再接続方法) の資格情報	確立する (または再確立する) ときに使用する認証方法を指定する接続です。この属性の値は、 ST_CredMethodの単純型 (§18.18.16) によって定義されます。
削除された (削除された接続)	関連付けられているブックの接続が削除されたかどうかを示します。 true の場合、接続が削除されました。それ以外の場合、 false を指定します。削除した接続に名前を削除した属性のみが含まれている =true、SpreadsheetML ファイルから他のすべての情報が削除されます。削除された接続と同じ名前を使用して新しい接続を作成する場合、削除された接続は、新しい接続によって上書きされます。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
説明 (接続)	この接続のユーザーの説明を指定します。この属性の値は、 ST_Xstringの単純型 (§22.9.2.19) によって定義されます。
id (接続 Id)	この接続の一意の識別子を指定します。この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
間隔 (自動更新間隔)	接続の自動更新間隔を分単位の数を指定します。この属性が存在しない場合、接続は自動的に更新されません。この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
キープアライブ (保持接続オープン)	true のスプレッドシートアプリケーションが接続を維持する努力開くようにするとします。場合false、アプリケーション接続が閉じ、情報を取得した後。 PivotCache オブジェクトの MaintainConnection プロパティが該当します。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
(バージョンに必要な最小限の更新) minRefreshableVersion	従来のスプレッドシート・アプリケーションとの互換性です。これは、最低限のバージョンを表します。データ接続を正しく更新することができるために必要な番号。この属性は、クエリテーブルで使用されている接続に適用されます。 UnsignedByteの W3C XML スキーマデータ型では、この属性の有効な値が定義されています。
(接続名)	接続の名前を指定します。各接続では、一意の名前を持ちます。接続は、削除済みとしてマークされているし、同じ名前の新しい接続を追加し、削除された接続は、新しい接続を使用して交換してください。この属性の値は、 ST_Xstringの単純型 (§22.9.2.19) によって定義されます。
新しい (新しい接続の場合)	trueを最初に接続が更新されていない場合それ以外の場合、 false を指定します。この状態は、クエリが返すことを完了する前に、ユーザーがファイルを保存するときに発生します。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
odcFile (接続ファイル)	この接続の作成元である外部接続ファイルへの完全パスを指定します。データ、および reconnectionMethod の更新の試行中に、接続が失敗した場合は =1の場合は、スプレッドシートアプリケーションは、ブックに埋め込まれている接続オブジェクトの代わりに外部接続ファイルから情報を使用して再度実行してください。これは、データソースと spreadsheetML ドキュメント管理の容易性のメリットです。場合 (データベースサーバー名の変更) のため、外部接続ファイル内の定義を変更すると、作成するブックを使用しての接続の内部的な接続情報を接続し、新しい接続を再読み込みに失敗します。このファイルからの情報です。ユーザーがブック内の接続の定義を手動で編集すると、スプレッドシートアプリケーションでこの属性がクリアされます。またはシステムに固有で表すことができますファイルのパスの表記法です。 [メモ: アプリケーションは、これらのフォームのサポート、およびシステム固有のファイルのパス表記法をサポートするかどうかを決定できます。メモの終了) この属性の値は、 ST_Xstringの単純型 (§22.9.2.19) によって定義されます。
onlyUseConnectionFile (のみ接続ファイルを使用)	スプレッドシートアプリケーションが常にする必要があり、だけ接続が更新されたときに、odcFile 属性で示されている外部接続ファイルの接続情報を使用するかどうかを示します。場合はfalse を指定し、スプレッドシートアプリケーション以下で説明する reconnectionMethod 属性で示された手順に従います。適用されるその他の種類の接続の OLE DB および ODBC の接続にのみこの属性は無視されます。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
reconnectionMethod (再接続方法)	スプレッドシートアプリケーションに行うべき接続が失敗したときを指定します。値は次のとおりです。 1 = 必要に応じて: 更新時に既存の接続情報を使用します。接続を確立するために既存の情報を使用できない場合は、外部接続ファイルから利用可能な場合、更新された接続情報を取得します。 2 = 常に: すべての更新時に利用可能な場合、外部接続ファイルから、更新された接続情報を取得し、既存の接続情報の代わりに使用します。ここでは、外部接続ファイルが使用できない場合、データの更新は失敗します。 3 = なし: 既存の接続情報を使用できない場合でも、利用可能な場合でもに get が外部接続ファイルから接続情報を更新することはありません。この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。
refreshedVersion (最終更新版)	下位互換性を保つのためには、この属性は、接続を最後に更新したスプレッドシートアプリケーションのバージョンを示します。この属性は、クエリテーブルで使用されている接続に適用されます。 UnsignedByteの W3C XML スキーマデータ型では、この属性の有効な値が定義されています。
refreshOnLoad (開いたときに更新)	true の場合、ファイルを開くときにこの接続を更新する必要があります。それ以外の場合、 false を指定します。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
saveData (データの保存)	ブックと共に保存するのにはtrue を指定するテーブルを作成する接続上で外部データがフェッチされる場合、します。それ以外の場合、 false を指定します。ブック内のデータセキュリティのために外部データを保存しない場合 (「キャッシュ」) が存在するこの、関連のデータを取得し、ユーザーデータは表示されませんするたびに資格情報を必要になることができますし、現在のユーザー、ブックの作成者最後で使用されていたする前にファイルを保存しています。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
savePassword (パスワードの保存)	true の場合は、パスワードが接続文字列の一部として保存するのにはそれ以外の場合、False です。この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
singleSignOnId (SSO Id)	識別子のシングルサインオン (SSO) の中間の spreadsheetML サーバーと外部データソースの認証に使用します。 [注: データ接続は、いくつかの異なるテクノロジを使用できます。潜在的な値をこの属性に格納されている 1 つの例があります: http://msdn.microsoft.com/library/default.asp?url=/library/en-us/spptsdk/html/cSSOReturnCodes_SV01001109.asp メモの終わり] この属性の値は、 ST_Xstringの単純型 (§22.9.2.19) によって定義されます。
ソースファイル (元のデータベースファイル)	外部データソースでは、ファイル・ベースの場合に使用します。このようなデータソースへの接続が失敗すると、スプレッドシートアプリケーションはこのファイルに直接接続しようとします。またはシステムに固有で表すことができますファイルのパスの表記法です。 [メモ: アプリケーションは、これらのフォームのサポート、およびシステム固有のファイルのパス表記法をサポートするかどうかを決定できます。メモの終了) この属性の値は、 ST_Xstringの単純型 (§22.9.2.19) によって定義されます。
種類 (データベースのソースの種類)	データソースの種類を指定します。値は次のとおりです。 1. ODBC ベースのソース 2. DAO ベースのソース 3. ファイルベースのデータベースソース 4. web クエリ 5. OLE DB ベースのソース 6. テキスト・ベースのソース 7. レコードセット 8。 DSP この属性に指定できる値は、W3C XML スキーマの unsignedInt データ型で定義されます。

[注: この要素のコンテンツモデル (CT_Connection) の W3C XML スキーマ定義は §A.2 であります。 メモの終了)

ISO/IEC29500: 2008。

コンストラクター

Connection()	接続クラスの新しいインスタンスを初期化します。
Connection(IEnumerable<OpenXmlElement>)	指定した子要素を使用して接続クラスの新しいインスタンスを初期化します。
Connection(OpenXmlElement[])	指定した子要素を使用して接続クラスの新しいインスタンスを初期化します。
Connection(String)	外側の XML からの接続クラスの新しいインスタンスを初期化します。

プロパティ

Background	背景です。スキーマでは、次の属性を表しますバックグラウンド。
ChildElements	現在の要素のすべての子ノードを取得します。 (継承元 OpenXmlElement)
ConnectionExtensionList	ConnectionExtensionList。スキーマでは、次の要素タグを表します: x: extLst
ConnectionFile	odcFile.Represents は、次のスキーマの属性: odcFile
Credentials	資格情報です。スキーマでは、次の属性を表します資格情報。
DatabaseProperties	データベースプロパティです。スキーマでは、次の要素タグを表します: x: dbPr
Deleted	削除されます。スキーマでは、次の属性を表します: 削除
Description	説明します。スキーマでは、次の属性を表します: 説明
ExtendedAttributes	現在の要素のすべての拡張属性 (スキーマで定義されていない属性) を取得します。 (継承元 OpenXmlElement)
FirstChild	現在の OpenXmlElement 要素の最初の子を取得します。 (継承元 OpenXmlCompositeElement)
HasAttributes	現在の要素に属性が含されているかどうかを示すブール値を取得します。 (継承元 OpenXmlElement)
HasChildren	現在の要素に子要素が含されているかどうかを示す値を取得します。 (継承元 OpenXmlCompositeElement)
Id	id です。スキーマでは、次の属性を表します id。
InnerText	現在のノードとそのすべての子の連結値を取得または設定します。 (継承元 OpenXmlCompositeElement)
InnerXml	現在のノードの子ノードのみを表すマークアップを取得または設定します。 (継承元 OpenXmlCompositeElement)
Interval	間隔です。スキーマでは、次の属性を表します: 間隔
KeepAlive	keepAlive.Represents は、次のスキーマの属性: キープアライブ
LastChild	現在の OpenXmlElement 要素の最後の子を取得します。このような OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlCompositeElement)
LocalName	要素のローカル名を取得します。
MCAttributes	マークアップの互換性属性を設定します。現在の要素に対してマークアップ互換性属性が定義されていない場合は null を返します。 (継承元 OpenXmlElement)
MinRefreshableVersion	スキーマの属性の次の minRefreshableVersion.Represents: minRefreshableVersion
Name	名前です。スキーマでは、次の属性を表します: 名前
NamespaceDeclarations	現在の要素で定義されている名前空間宣言を取得します。名前空間宣言がない場合は、空の列挙子を返します。 (継承元 OpenXmlElement)
NamespaceUri	現在の要素の名前空間 URI を取得します。 (継承元 OpenXmlElement)
New	新機能。スキーマでは、次の属性を表します: 新規
OlapProperties	OlapProperties。スキーマでは、次の要素タグを表します: x: olapPr
OnlyUseConnectionFile	スキーマの属性の次の onlyUseConnectionFile.Represents: onlyUseConnectionFile
OpenXmlElementContext	現在の要素の OpenXmlEementContext を取得します。 (継承元 OpenXmlElement)
OuterXml	現在の要素とそのすべての子要素を表すマークアップを取得します。 (継承元 OpenXmlElement)
Parameters	パラメーターです。スキーマでは、次の要素タグを表します: x パラメーター。
Parent	現在の要素の親要素を取得します。 (継承元 OpenXmlElement)
Prefix	現在の要素の名前空間プレフィックスを取得します。 (継承元 OpenXmlElement)
ReconnectionMethod	スキーマの属性の次の reconnectionMethod.Represents: reconnectionMethod
RefreshedVersion	スキーマの属性の次の refreshedVersion.Represents: refreshedVersion
RefreshOnLoad	スキーマの属性の次の refreshOnLoad.Represents: refreshOnLoad
SaveData	saveData.Represents は、次のスキーマの属性: saveData
SavePassword	スキーマの属性の次の savePassword.Represents: savePassword
SingleSignOnId	スキーマの属性の次の singleSignOnId.Represents: singleSignOnId
SourceFile	sourceFile.Represents は、次のスキーマの属性: ソースファイル
TextProperties	TextProperties。スキーマでは、次の要素タグを表します: x: textPr
Type	入力します。スキーマでは、次の属性を表します種類。
WebQueryProperties	WebQueryProperties。スキーマでは、次の要素タグを表します: x: webPr
XmlQualifiedName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)
XName	現在の要素の修飾名を取得します。 (継承元 OpenXmlElement)

メソッド

AddAnnotation(Object)	現在の OpenXmlElement 要素の注釈の一覧にオブジェクトを追加します。 (継承元 OpenXmlElement)
AddNamespaceDeclaration(String, String)	現在のノードに namepace 宣言を追加します。 (継承元 OpenXmlElement)
Ancestors()	現在の要素のすべての先祖を列挙します。 (継承元 OpenXmlElement)
Ancestors<T>()	指定した型を持つ現在の要素の先祖のみを列挙します。 (継承元 OpenXmlElement)
Annotation(Type)	現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。 (継承元 OpenXmlElement)
Annotation<T>()	現在の OpenXmlElement 要素から、指定した型の最初の注釈オブジェクトを取得します。 (継承元 OpenXmlElement)
Annotations(Type)	現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。 (継承元 OpenXmlElement)
Annotations<T>()	現在の OpenXmlElement 要素の指定した型を持つ注釈のコレクションを取得します。 (継承元 OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	要素のリストから、現在の要素の子要素のリストの末尾に各要素を追加します。 (継承元 OpenXmlElement)
Append(OpenXmlElement[])	要素の配列から、現在の要素の子要素のリストの末尾に各要素を追加します。 (継承元 OpenXmlElement)
AppendChild<T>(T)	指定した要素を、現在の要素の子ノードのリストの末尾に追加します。 (継承元 OpenXmlCompositeElement)
ClearAllAttributes()	既知の属性と拡張属性の両方を含む、すべての属性をクリアします。 (継承元 OpenXmlElement)
Clone()	現在のノードの複製を作成します。 (継承元 OpenXmlElement)
CloneNode(Boolean)	このノードの複製を作成します。
Descendants()	現在の要素のすべての子孫を列挙します。 (継承元 OpenXmlElement)
Descendants<T>()	現在の要素の T 型のすべての子孫を列挙します。 (継承元 OpenXmlElement)
Elements()	現在の要素のすべての子を列挙します。 (継承元 OpenXmlElement)
Elements<T>()	指定した型を持つ現在の要素の子のみを列挙します。 (継承元 OpenXmlElement)
ElementsAfter()	現在の要素に従い、現在の要素と同じ親を持つすべての兄弟要素を列挙します。 (継承元 OpenXmlElement)
ElementsBefore()	現在の要素の前に、現在の要素と同じ親を持つすべての兄弟要素を列挙します。 (継承元 OpenXmlElement)
GetAttribute(String, String)	指定したタグ名と名前空間 URI を持つ Open XML 属性を取得します。 (継承元 OpenXmlElement)
GetAttributes()	すべての属性のコピーを含むリストを取得します。 (継承元 OpenXmlElement)
GetEnumerator()	子コレクションを反復処理する列挙子を返します。 (継承元 OpenXmlElement)
GetFirstChild<T>()	型 T の最初の子要素を検索します。 (継承元 OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	指定した参照要素の直後に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	現在の要素の直後に指定した要素を挿入します。 (継承元 OpenXmlElement)
InsertAt<T>(T, Int32)	現在の要素の子の指定したインデックスに、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	指定した参照要素の直前に、指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	現在の要素の直前に指定した要素を挿入します。 (継承元 OpenXmlElement)
IsAfter(OpenXmlElement)	ドキュメントの順序で指定した要素の後に現在の要素が表示されるかどうかを指定します。 (継承元 OpenXmlElement)
IsBefore(OpenXmlElement)	現在の要素が文書の順序で指定された要素の前に表示されるかどうかを指定します。 (継承元 OpenXmlElement)
LookupNamespace(String)	現在のノードのコンテキストで名前空間プレフィックスを解決します。 (継承元 OpenXmlElement)
LookupPrefix(String)	現在の要素スコープ内の名前空間 uri の対応するプレフィックスを検索します。 (継承元 OpenXmlElement)
NextSibling()	現在の OpenXmlElement 要素の直後にある OpenXmlElement 要素を取得します。次の OpenXmlElement 要素がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement)
NextSibling<T>()	現在の OpenXmlElement 要素に続く、指定した型を持つ OpenXmlElement 要素を取得します。次の OpenXmlElement がないVisual Basic null (Nothing in Visual Basic) を返します。 (継承元 OpenXmlElement)
PrependChild<T>(T)	現在の要素の子ノードのリストの先頭に指定した要素を挿入します。 (継承元 OpenXmlCompositeElement)
PreviousSibling()	現在の OpenXmlElement 要素の直前にある OpenXmlElement 要素を取得します。前の OpenXmlElement 要素がないVisual Basic null ( Nothing in Visual Basic ) を返します。 (継承元 OpenXmlElement)
PreviousSibling<T>()	現在の OpenXmlElement の前に指定された型を持つ OpenXmlElement 要素を取得します。前の OpenXmlElement 要素がない場合は、null (Visual Basic 内の Nothing) を返します。 (継承元 OpenXmlElement)
Remove()	現在の要素を親から削除します。 (継承元 OpenXmlElement)
RemoveAllChildren()	現在の要素のすべての子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveAllChildren<T>()	T 型の現在の要素のすべての子要素を削除します。 (継承元 OpenXmlElement)
RemoveAnnotations(Type)	現在の OpenXmlElement 要素から、指定した型の注釈を削除します。 (継承元 OpenXmlElement)
RemoveAnnotations<T>()	現在の OpenXmlElement 要素から、指定した型の注釈を削除します。 (継承元 OpenXmlElement)
RemoveAttribute(String, String)	現在の要素から属性を削除します。 (継承元 OpenXmlElement)
RemoveChild<T>(T)	指定した子要素を削除します。 (継承元 OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	指定したプレフィックスの名前空間宣言を削除します。プレフィックスがない場合は何も削除しません。 (継承元 OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	現在の要素の子要素の 1 つを別の OpenXmlElement 要素に置き換える。 (継承元 OpenXmlCompositeElement)
SetAttribute(OpenXmlAttribute)	属性を指定した要素に設定します。属性が既知の属性の場合、属性の値が設定されます。属性が拡張属性の場合、'openxmlAttribute' が拡張属性リストに追加されます。 (継承元 OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	要素に対して多数の属性を設定します。属性が既知の属性の場合、属性の値が設定されます。属性が拡張属性の場合、'openxmlAttribute' が拡張属性リストに追加されます。 (継承元 OpenXmlElement)
WriteTo(XmlWriter)	現在のノードを指定した XmlWriter に保存します。 (継承元 OpenXmlElement)

明示的なインターフェイスの実装

IEnumerable.GetEnumerator()

(継承元 OpenXmlElement)

適用対象